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FOREWORD 


This  addition  to  the  Effective  Date  (E-DATE)  Model  documentation  (CAA-D-85- 
6)  has  been  prepared  to  record  the  development  of  an  adjunct  program  to  the 
E-DATE  Model,  designated  the  Request  Processor.  The  Request  Processor  is  a 
stand-alone,  interactive  program  which  uses  computer-generated  screens  to 
guide  the  use  of  the  model  through  the  steps  necessary  for  control  and 
operation  of  the  model.  The  processor  development  was  included  as  a  model 
enhancement  task  to  provide  the  model  with  a  "user  friendly"  interface. 

The  Request  Processor  is  sufficiently  different  from  the  other  processors 
in  its  purpose,  design,  concept,  and  implementation  (in  COBOL)  to  warrant 
documentation  as  a  separate  entity.  This  publication  has  been  prepared  to 
include  each  of  the  documentation  types  provided  for  the  basic  model, 
namely: 

•  Functional  Description  -  Part  I 

•  User's  Manual  -  Part  II 

•  Computer  Operation  Manual  -  Part  III 

•  Program  Maintenance  Manual  -  Part  IV 

Each  part  includes  the  topics  appropriate  to  the  documentation  type 
prescribed  by  the  DOD  Automation  Data  Systems  Documentation  Standards  (DOD 
7935. 1-S). 
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The  classified  references  in  these  reports 
do  not  contain  classified  information  per 
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SECTION  2.  SYSTEM  SUMMARY 

2.1.  System  AppI ication 

The  E-DATE  Model  provides  information  to  logistics  staff  officers 
(users)  on  the  equipment  readiness  of  units  based  on  (TAEDP)  pro¬ 
jected  equipment  fills.  With  this  information,  the  user  can  form  a 
judgment  as  to  the  adequacy  of  the  fill  with  respect  to  both  the 
capacity  of  an  individual  unit  to  carry  out  its  mission  and  the 
capacity  of  groups  of  units  tc  contribute  to  force  readiness. 

The  Request  Processor  facilitates  this  process  by  prompting  the  user 
for  the  necessary  inputs  for  carrying  out  a  particular  run  and  then 
responding  to  a  request  to  start  the  run. 

2.2.  System  Operation 

The  Request  Processor  is  a  standalone  program  which  calls  custom 
designed,  computer-generated  full  screens.  These  screens  are 
designed  to  prompt  the  user  for  selected  groups  of  information, 
check  the  validity  of  the  entries,  and  then  pass  the  information  to 
a  file  for  subsequent  access  by  the  E-DATE  Model. 

2.3.  System  Configuration 

The  Request  Processor  is  resident  on  the  Sperry  1100/62  Timesharing 
Multiprocessing  System  at  LEA.  The  processor  was  developed  with  the 
38R5A  level  of  the  EXEC  and  5R2C  level  of  the  COBOL  compiler.  The 
processor  should  remain  compatible  with  later  releases  of  the  system 
software. 

2.3.1.  System  Organization 

The  utility  program  generates  a  set  of  14  screens  (Figure  II-2-1). 

a.  The  MENU  Screen  (#1)  is  the  master  directory  to  the  other 
screens.  It  allows  the  user  to  select  among  three  separate 
aspects  of  E-DATE  Model  operation,  namely: 

ORIENTATION  TO  MODEL 
MODEL  DATA  PREPARATION 
MODEL  OPERATION 

b.  The  ORIENTATION  TO  MODEL  Screen  (#2)  provides  the  user  with  a 
multiple  page  summary  of  the  E-DATE  Model. 
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PART  II  -  USER'S  MANUAL 

SECTION  1.  GENERAL  DESCRIPTION 

1.1.  Purpose  of  the  User's  Manual 

This  User's  Manual  for  the  Request  Processor  provides  user  non-ADP 
personnel  with  the  information  necessary  to  effectively  utilize  the 
model . 

1.2.  Project  References 

a.  Effective  Date  (E-DATE)  Model  Documentation,  CAA-D-85-6,  US  Army 
Concepts  Analysis  Agency,  Bethesda,  MD,  May  1985. 

(1)  Volume  I  -  Functional  Description 

(2)  Volume  II  -  User's  Manual 

(3)  Volume  III  -  Computer  Operation  Manual 

(4)  Volume  IV  -  Program  Maintenance  Manual 

b.  Management  of  MTOE  Effective  Dates  Based  on  Equipment 
Availability  (MTO  Dates),  CAA-SR-83-3,  US  Army  Concepts  Analysis 
Agency,  Bethesda,  MD,  July  1983. 

c.  Effective  Date  (E-DATE)  Model  Enhancement,  CAA-SR-84-17 ,  US  Army 
Concepts  Analysis  Agency,  Bethesda,  MD,  July  1984. 

1.3.  Terms  and  Abbreviations 
See  Glossary. 

1.4.  Security  and  Privacy 
Not  applicable. 
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SECTION  6.  SYSTEM  DEVELOPMENT  PLAN 
Not  applicable. 
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SECTION  5.  COST  FACTORS 
Not  applicable. 
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SECTION  4.  ENVIRONMENT 

4.1.  Equipment  Environment 

The  Request  Processor  is  resident  on  the  Sperry  1100/62  Timesharing 
Multiprocessing  System  at  the  Logistics  Evaluation  Agency  (LEA). 
Off-site  access  to  the  LEA  system  is  provided  through  terminal 
devices  including  the  UTS  20  and  associated  controller  located  in 
the  ODCSLOG  work  area  in  the  Pentagon. 

4.2.  Support  Software  Environment 

The  Request  Processor  requires  the  availability  of  the  Sperry 
Display  Processing  System  to  enable  generation  of  the  full  screen 
displays.  In  addition,  the  processor  requires  the  availability  of 
the  Sperry  COBOL  compiler,  collector,  and  associated  libraries  in 
the  event  that  any  changes  to  the  processor  code  are  to  be  made. 

4.3.  Interface 

Not  applicable 

4.4.  Security  and  Privacy 

4.4.1.  Security 

The  Request  Processor  code  is  UNCLASSIFIED.  The  files  accessed  and 
generated  by  the  processor  are  at  most  CONFIDENTIAL.  However,  these 
files  are  both  generated  and  employed  internal  to  the  computer 
system  and  are  totally  transparent  to  the  user.  See  Part  III  - 
Computer  Operation  Manual,  paragraph  2.4.,  for  the  identification  of 
these  files. 

4.4.2.  Privacy 

Not  applicable. 
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3.3.1.  System  Performance 


a.  Inputs 
Screen  Inputs 

The  Request  Processor  generates  a  total  of  14  screens.  All  but 
one  require  the  user  to  either  make  a  selection  or  insert  values. 

Mass  Storage  Inputs 

The  Request  Processor  accesses  mass  storage  files  to  extract: 

•  Runstream  commands  from  prototype  runstreams 

•  Previously  generated  run  control  parameter  files  for  update 
purposes 

b.  Outputs 

The  Request  Processor  generates  mass  storage  files  containing: 

•  Run  control  parameters  subsequently  accessed  by  the  E-DATE 
Model  during  run  execution 

•  Runstream  files  for  execution 

c.  Limitations 


Not  applicable. 

3.4.  Data  Characteristics 

Both  the  input  data  and  output  data  files  of  the  processor  are  on 
mass  storage  files. 

3.5.  Failure  Contingencies 

Refer  to  Part  II  -  User's  Manual,  paragraph  3.8.,  for  a  discussion 
of  failure  contingencies. 
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Figure  1-3-1.  Request  Processor  Screens 
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j.  The  SINGLE  WACOM  SELECTION  Screen  (#10)  allows  the  user  to  select 
an  individual  WACOM  to  be  involved  in  the  equipment  redistribu¬ 
tion  process.  This  selection  is  only  applicable  to  the  data  set 
associated  with  "changed  units"  and  is  provided  for  use  in  the 
future.  The  E-DATE  Model  does  not  presently  support  redistribu¬ 
tion  of  equipment  among  "changed  units." 

k.  The  POOL  SELECTION  CRITERIA  Screen  (#11)  allows  the  user  to  select 
the  parameters  which  control  the  units  selected  for  uprate  to  a 
higher  C-level  of  readiness  and  the  units  to  be  selected  for 
downrate  to  a  lower  C-level  of  readiness  (to  release  assets  to 
uprated  units). 

l.  The  UNIT  TARGET  RATING  Screen  (#12)  allows  the  user  to  select 
the  C-ratings  to  be  associated  with  particular  uprated  and  down¬ 
rated  units. 

m.  The  MODEL  OPERATION  Screen  (#13)  allows  the  user  to  "start"  or 
"stop"  the  E-DATE  Model  in  any  of  its  several  modes  of  operation. 

n.  The  STOP  RUN  Screen  (#14)  is  automatically  generated  by  the 
processor  each  time  the  user  selects  the  "stop  run"  option  on 
Screen  #13.  It  displays  the  job  identification  of  the  run  to  be 
terminated.  It  also  displays  the  AUTOVON  number  of  the  LEA 
computer  operator  to  be  contacted  to  take  the  action  to  ter¬ 
minate  the  run. 
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d.  The  selection  of  the  Data  Set  Parameter  Sequence  causes  the 
following  screens  to  be  presented  in  turn: 

DATA  SET  IDENTIFICATION 
UNPROGRAMED  UNIT  PARAMETERS 
UNPROGRAMED  UNIT  BILLPAYERS 

The  DATA  SET  IDENTIFICATION  Screen  (#4)  allows  the  user  to 
identify  the  data  sets  (units  and  associated  equipment)  to  be 
retrieved  from  the  TAEDP  data  tape. 

e.  The  UNPROGRAMED  UNIT  PARAMETERS  Screen  (#5)  allows  the  user  to 
identify  the  parameters  used  by  the  E-DATE  Model  to  create  new 
(unprogramed)  units. 

f.  The  UNPROGRAMED  UNIT  BILLPAYERS  SCREEN  (#6)  allows  the  user  to 
identify  the  units  from  which  equipment  may  be  transferred  to 
fill  the  newly  created  units. 

g.  The  selection  of  the  Rating  Data  Parameters  sequence  causes  the 
following  screens  to  be  presented  in  turn: 

FISCAL  YEAR  RANGE  SELECTION 
MACOM  SET  SELECTION 

The  FISCAL  YEAR  RANGE  SELECTION  Screen  (#7)  allows  the  user  to 
select  the  particular  range  of  fiscal  years  of  interest  from  the 
seven  fiscal  years  present  in  the  TAEDP  data. 

h.  The  MACOM  SET  SELECTION  Screen  (#8)  allows  the  user  to  select 
the  particular  major  commands  (MACOM)  of  interest  from  the  13 
MACOM  defined  in  the  TAEDP  data.  This  selection  of  MACOM  is 
(only)  used  in  conjunction  with  the  data  set  associated  with 
"changed  units." 

i.  The  selection  of  the  Redistribution  Data  Parameters  sequence 
causes  the  following  screens  to  be  presented  in  turn: 

SINGLE  FISCAL  YEAR  SELECTION 
SINGLE  MACOM  SELECTION 
POOL  SELECTION  CRITERIA 
UNIT  TARGET  RATING 

The  SINGLE  FISCAL  YEAR  SELECTION  Screen  (#9)  allows  the  user  to 
select  the  particular  fiscal  year  to  be  involved  in  the  equipment 
redistribution  process. 
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SECTION  3.  DETAILED  CHARACTERISTICS 

3.1.  Specific  Performance  Requirements 

3.1.1.  Accuracy  and  Validity 
Not  applicable. 

3.1.2.  T iminq 

Not  appl icable. 

3.2.  System  Functions 

3.2.1.  Screen  Management 

The  Request  Processor  leads  the  user  through  the  steps  needed  to 
prepare  the  model  for  operation  and  allows  the  user  to  start  and 
stop  the  model,  all  with  only  a  minimal  familiarity  with  computer 
system  operating  procedures.  The  processor  presents  the  user  with  a 
series  of  choices  as  to  the  task  to  be  performed.  The  user  indicates 
the  task  of  interest,  and  the  processor  responds  with  a  screen 
soliciting  values  appropriate  to  the  task.  The  user  enters  these 
values,  and  the  processor  performs  basic  validity  checks.  If  errors 
are  encountered,  the  user  is  prompted  for  a  corrected  input.  Other¬ 
wise,  the  processor  moves  on  to  solicit  another  task  until  all  the 
necessary  inputs  are  prepared  or  the  user  indicates  the  session  is 
to  be  terminated. 

3.2.2.  Individual  Screens 


The  processor  program  generates  a  set  of  14  screens  (Figure  1-3-1). 

a.  The  MENU  Screen  (#1)  is  the  master  directory  to  the  other  screens. 
It  allows  the  user  to  select  among  three  separate  aspects  of 
E-DATE  Model  operation,  namely: 

ORIENTATION  TO  MODEL 
MODEL  DATA  PREPARATION 
MODEL  OPERATION 

b.  The  ORIENTATION  TO  MODEL  Screen  (#2)  provides  the  user  with  a 
multiple  page  summary  of  the  E-DATE  Model. 

c.  The  MODEL  DATA  PREPARATION  Screen  (#3)  act  as  a  submenu  to  allow 
the  user  to  select  a  particular  data  preparation  sequence,  namely: 

DATA  SET  IDENTIFICATION 
RATING  DATA  PARAMETERS 
REDISTRIBUTION  DATA  PARAMETERS 
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2.3.2.  Information  Clusters 


The  information  is  also  organized  to  group  related  items  together. 
The  size  of  the  cluster  must  also  be  scaled  to  the  size  of  the  (full 
screen)  display  area  available  to  the  user,  as  the  means  of  inter¬ 
action  with  the  computer. 

2.4.  Summary  of  Improvements 

The  Request  Processor  supports  the  decision  support  capability  of 
the  E-DATE  Model  by  facilitating  the  ability  of  the  user  to  interact 
with  the  model.  The  following  improvements  are  provided: 

•  Identification  of  the  choices  of  model  operation  available 

0  Identification  of  the  user  inputs  associated  with  the  chosen 
operation 

0  Verification  of  the  user  inputs  for  legality 
0  Automatic  assembly  and  execution  of  the  model  runs 

2.5.  Summary  of  Impacts 

The  users  of  the  E-OATE  Model  can  expect  to  experience: 

0  Shorter  orientation  time  to  achieve  facile  use  of  the  model 
0  Shorter  run  preparation  time 

0  Greater  awareness  of  factors  used  by  the  model  to  organize  and 
process  data 

2.6.  Assumptions  and  Constraints 


The  host  computer  for  the  E-OATE  Model  also  supports  the  Sperry 
Display  Processing  System  (DPS)  used  by  the  Request  Processor  to 
generate  the  full  screen  displays  used  to  prompt  the  user  for  model 
control  inputs. 


SECTION  2.  SYSTEM  SUMMARY 


2.1.  Background 

The  US  Army  Concepts  Analysis  Agency  (CAA)  developed  (ref  1.2b)  the 
Effective  Date  (E-DATE)  Model  in  response  to  tasking  by  the  Office 
of  the  Deputy  Chief  of  Staff  for  Logistics  (ODCSLOG).  The  tasking 
called  for  the  development  of  a  methodology  to  assist  logistics  staff 
officers  in  responding  to  questions  /rom  the  Deputy  Chief  of  Staff 
for  Operations  and  Plans  (DCSOPS)  about  the  adequacy  of  the  fill  of 
selected  Army  units. 

The  model  has  since  undergone  a  round  of  enhancements  (ref.  1.2c)  to 
improve  its  capability,  including  an  enhancement  ip  make  the  model 
more  "user  friendly."  In  implementing  this  latter  capability,  the 
emphasis  was  placed  on  simplification  of  input  procedures,  with  a 
presumption  of  minimum  user  familiarity  with  computer  operation. 

2.2.  Objectives 

The  Request  Processor  has  been  designed  to  provide  the  ODCSLOG  with 
the  following: 

•  A  general  purpose  capability  to  operate  the  E-DATE  Model  in  all 
its  modes. 

•  Minimal  user  involvement  with  specialized  computer  commands. 

•  Maximal  use  of  user  oriented  terminology  during  interaction  with 
the  processor. 

2.3.  Methods  and  Procedures 

In  the  development  of  the  Request  Processor,  two  basic  concepts  were 
employed,  as  follows: 

•  Information  Hierarchy 

•  Information  Clusters 
2.3.1.  Information  Hierarchy 


The  information  necessary  to  operate  the  E-DATE  Model  is  organized 
to  reflect  the  order  of  use  by  the  processors.  That  is,  the  infor¬ 
mation  needed  first  by  the  model  is  requested  first  and  stored. 

Using  this  approach,  the  user  is  introduced  to  the  structure  of  the 
operations  and  prevented  from  attempting  to  carry  out  operations  out 
of  sequence. 
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b.  Model  Development 

Director,  US  Army  Concepts  Analysis  Agency 
ATTN:  CSCA-FSL  (Logistics  Systems  Analysis  Division) 
8120  Woodmont  Avenue 
Sethesda,  MO  20814 

c.  Model  Operation  and  Maintenance 

Commander,  US  Army  Logistics  Evaluation  Agency 
ATTN:  DALO-LED  (Data  Processing  Center) 

New  Cumberland  Army  Depot 
New  Cumberland,  PA  17070 

1.3.  Terms  and  Abbreviations 


See  Glossary  at  the  end  of  this  publication. 
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PART  I  -  FUNCTIONAL  DESCRIPTION 


SECTION  1,  GENERAL  DESCRIPTION 

1.1.  Purpose  of  the  Functional  Description 

This  Functional  Description  for  the  Request  Processor  supplements 
the  Functional  Description  of  the  E-DATE  Model.  It  presumes  reader 
familiarity  with  the  E-DATE  Model  Functional  Description  and  is 
written  to  provide: 

a.  The  Request  Processor  requirements  to  be  satisfied  which  will 
serve  as  a  basis  for  mutual  understanding  between  the  user  and 
the  developer. 

b.  Information  on  the  Request  Processor  performance  requirements, 
preliminary  design,  and  user  impacts. 

c.  A  basis  for  the  development  of  the  Request  Processor  tests. 

1.2.  Project  References 

a.  Effective  Date  (E-DATE)  Model  Documentation,  CAA-D-85-6,  US  Army 
Concepts  Analysis  Agency,  Bethesda,  MD,  May  1985. 

(1)  Volume  I  -  Functional  Description 

(2)  Volume  II  -  User's  Manual 

(3)  Volume  III  -  Computer  Operation  Manual 

(4)  Volume  IV  -  Program  Maintenance  Manual 

b.  Management  of  MTOE  Effective  Dates  Based  on  Equipment 
Availability  (MTO  Dates),  CAA-SR-83-3,  US  Army  Concepts  Analysis 
Agency,  Bethesda,  MD,  July  1983. 

c.  Effective  Date  (E-OATE)  Model  Enhancement,  CAA-SR-84-17,  US  Army 
Concepts  Analysis  Agency,  Bethesda,  MD,  July  1984. 

1.2.1.  Points  of  Contact 

a.  Model  Utilization 

Deputy  Chief  of  Staff  for  Logistics 
ATTN:  DALO-SMD 
Department  of  the  Army 
Washington,  DC  20310 
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c.  The  MODEL  DATA  PREPARATION  Screen  (#3)  acts  as  a  submenu  to  allow 
the  user  to  select  a  particular  data  preparation  sequence,  namely: 

DATA  SET  IDENTIFICATION 
RATING  DATA  PARAMETERS 
REDISTRIBUTION  DATA  PARAMETERS 

d.  The  selection  of  the  Data  Set  Parameter  Sequence  causes  the  fol¬ 
lowing  screens  to  be  presented  in  turn; 

DATA  SET  IDENTIFICATION 
UNPROGRAMED  UNIT  PARAMETERS 
UNPROGRAMED  UNIT  BILLPAYERS 

The  DATA  SET  IDENTIFICATION  Screen  (#4)  allows  the  user  to  iden¬ 
tify  the  data  sets  (units  and  associated  equipment)  to  be 
retrieved  from  the  TAEDP  data  tape. 

e.  The  UNPROGRAMED  UNIT  PARAMETERS  Screen  (#5)  allows  the  user  to 
identify  the  parameters  used  by  the  E-DATE  Model  to  create  new 
(unprogramed)  units. 

f.  The  UNPROGRAMED  UNIT  BILLPAYERS  SCREEN  (#6)  allows  the  user  to 
identify  the  units  from  which  equipment  may  be  transferred  to 
fill  the  newly  created  units. 

g.  The  selection  of  the  Rating  Data  Parameters  sequence  causes  the 
following  screens  to  be  presented  in  turn: 

FISCAL  YEAR  RANGE  SELECTION 
MACOM  SET  SELECTION 

The  FISCAL  YEAR  RANGE  SELECTION  Screen  (#7)  allows  the  user  to 
select  the  particular  range  of  fiscal  years  of  interest  from  the 
seven  fiscal  years  present  in  the  TAEDP  data. 

h.  The  MACOM  SET  SELECTION  Screen  (#8)  allows  the  user  to  select 
the  particular  major  commands  (MACOM)  of  interest  from  the  13 
MACOM  defined  in  the  TAEDP  data.  This  selection  of  MACOM  is 
(only)  used  in  conjunction  with  the  data  set  associated  with 
"changed  units." 
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i.  The  selection  of  the  Redistribution  Data  Parameters  sequence 
causes  the  following  screens  to  be  presented  in  turn: 

SINGLE  FISCAL  YEAR  SELECTION 
SINGLE  WACOM  SELECTION 
POOL  SELECTION  CRITERIA 
UNIT  TARGET  RATING 

The  SINGLE  FISCAL  YEAR  SELECTION  Screen  (#9)  allows  the  user  to 
select  the  particular  fiscal  year  to  be  involved  in  the  equipment 
redistribution  process. 

j.  The  SINGLE  WACOM  SELECTION  Screen  (#10)  allows  the  user  to  select 
an  individual  WACOM  to  be  involved  in  the  equipment  redistribu¬ 
tion  process.  This  selection  is  only  applicable  to  the  data  set 
associated  with  "changed  units"  and  is  provided  for  use  in  the 
future.  The  E-DATE  Model  does  not  presently  support  redistribu¬ 
tion  of  equipment  among  "changed  units." 

k.  The  POOL  SELECTION  CRITERIA  Screen  (#11)  allows  the  user  to 
select  the  parameters  which  control  the  units  selected  for 
uprate  to  a  higher  C-level  of  readiness  and  the  units  to  be 
selected  for  downrate  to  a  lower  C-level  of  readiness  (to 
release  assets  to  uprated  units). 

l.  The  UNIT  TARGET  RATING  Screen  (#12)  allows  the  user  to  select 
the  C-ratings  to  be  associated  with  particular  uprated  and  down¬ 
rated  units. 

m.  The  MODEL  OPERATION  Screen  (#13)  allows  the  user  to  "start"  or 
"stop"  the  E-DATE  Model  in  any  of  its  several  modes  of  operation. 

n.  The  STOP  RUN  Screen  (#14)  is  automatically  generated  by  the  pro¬ 
cessor  each  time  the  user  selects  the  "stop  run"  option  on  Screen 
#13.  It  displays  the  job  identification  of  the  run  to  be  termi¬ 
nated.  It  also  displays  the  AUTOVON  number  of  the  LEA  computer 
operator  to  be  contacted  to  take  the  action  to  terminate  the 
run. 
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2.3.2.  System  Performance 

a.  Inputs 
Screen  Inputs 

The  Request  Processor  generates  a  total  of  14  screens.  All  but 
one  require  the  user  to  input  either  a  selection  or  insert  values. 

Mass  Storage  Inputs 

The  Request  Processor  accesses  mass  storage  files  to  extract: 

•  Runstream  commands  from  prototype  runstreams 

•  Previously  generated  run  control  parameter  files  for  update 
purposes 

b.  Outputs 

The  Request  Processor  generates  mass  storage  files  containing: 

•  Run  control  parameters  subsequently  accessed  by  the  E-DATE 
Model  during  run  execution 

0  Runstream  files  for  execution 

c.  Limitations 
Not  applicable. 

d .  Processing  Time 

The  screen  displays  generated  by  the  Request  Processor  are  pre¬ 
sented  and  processed  in  essentially  real  time. 

2.4.  Data  Base 


A  data  base  as  such  is  not  involved.  The  processor,  however,  does 
access  prototype  runstreams.  These  runstreams  (see  Part  III,  para 
3.2)  have  been  specially  edited  with  symbols  which  mark  off  the  run¬ 
stream  into  segments.  These  segments  are  used  by  the  processor  and 
assembled  into  the  appropriate  order  to  generate  the  required 
sequence  of  executions  of  the  E-OATE  Model. 
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SECTION  3.  STAFF  FUNCTIONS  RELATED  TO  TECHNICAL  OPERATION 

3.1.  Initialization  Procedures 

The  use  of  the  Request  Processor  involves  two  procedures,  designated 
the  Log-on  Procedure  and  the  Invoke  Procedure. 

3.2.  Log-on  Procedure 

The  procedure  to  log  on  the  computer  is  as  follows: 

Step  1  -  Initialize  the  System 

Press  the  "LOAD"  button  on  cluster  controller  in  order  to  boot 
the  4020  system  from  the  system  diskette  which  must  be  mounted 
in  the  Integral  Load  Device  (ILD). 

At  this  point,  if  you  wish  to  remote  print  output  from  the  host 
computer  (at  LEA),  enable  screen  bypass  mode  by  going  on  to 
Step  2. 

To  enable  local  printing  of  screen  displays,  go  to  Optional 
Step,  Part  B  below. 

Step  2  -  Screen  Bypass 

Sign  on  terminal 
Enter  User  ID/Password 
Enter  Account 
Enter  Project-ID 

OOSCBY  S00303 

If  a  screen  bypass  is  already  active,  go  on  to  Step  3. 

Reenter  User  ID/Password 
Reenter  Account 
Reenter  Project-ID 

OFIN 

OOTSBM 

Go  on  to  Step  3. 

Step  3  -  Load  Remote  Print  Utility 

To  initiate  the  load  of  the  remote  print  utility,  get  the 
control  page  and  then  change  the  XFER  and  search  field  as 
necessary  to: 


(**XFER**) 

(11/  /LR)SEARCH(RMTPRNT) 


Store  the  control  page  by  hitting  the  "Control  Page"  button. 

The  alarm  should  not  ring.  If  it  does,  check  the  status  on  the 
control.  At  this  time  a  prompt  of  K-100  should  come  up.  You 
should  see: 

K-100  Printer  MNEMONIC  ? 

Answer  -  PI 

K-110  Remote  Print  Interface  MNEMONIC  ? 

Answer  -  R1 

K-120  Host  Interface  (1=RSI;  2=0THER) 

Answer  -  1 

K-130  Host  Logical  Unit  Number 
Answer  -  1 

K-140  Number  of  Lines  ? 

Answer  -  24 

More  info  prompts  should  appear.  Go  back  to  the  control  page 
and  check  status. 

At  this  point,  files  should  be  able  to  be  printed  downline  from 
the  host. 

Optional  Step  -  Local  Print 

In  orde'-  to  get  an  "off-the-screen"  print  after  screen  bypass 
mode  has  been  established,  perform  the  following  steps: 

A.  Down  the  remote  print  utility  by  adjusting  the  control  page 
as  follows: 

(**XFER**) 

(Rl/  /RC)SEARCH(EXIT  ) 

Store  the  control  page  and  wait  for  the  "Search"  field  to 
say 

(RMTPRNT  TERMINATED  ) 

B.  Then  adjust  the  control  page  to  the  following: 

(**PRNT**)  (**XFER**) 

(  /PI/  )  (PI/  /AS) 

Store  the  control  page 

At  this  point  you  may  print  from  the  screen  by  simply 
oressing  the  "Print"  button. 


c. 


When  done,  restore  the  remote  print  utility  by  going  to 
Step  1  above. 


When  the  appropriate  steps  to  achieve  either  printing  option  have 
been  done  but  the  printing  will  not  work,  go  back  to  Step  1  and 
start  over.  Be  absolutely  certain  to  follow  each  step  as  it  is 
described  in  this  procedure. 

Invoke  Procedure 


The  Request  Processor  is  invoked  with  the  simple  command: 
raADD,L  MTOE*RP1PRG00.RUN 

In  response  to  this  command  the  processor  will  be  loaded  onto  the 
system  and  shortly  display  its  first  screen,  a  MENU  screen. 

Operation  Procedure 


a.  Proceed  to  exercise  the  screens  per  the  screen  instructions, 
using  the  "TAB  FWD"  and  "TAB  BACK"  keys  to  position  the  cursor 
to  the  appropriate  entries  on  the  screen.  Place  an  "X"  to  make 
a  selection  or  enter  values  directly  where  indicated.  Be  sure 
to  select  "ACTION"  at  bottom  of  screen  to  complete  entry 
sequence  (final  position  of  tab  is  not  significant).  Action 
selections  have  the  following  meaning: 

CONTINUE  -  process  entries  tabbed 

EXIT  -  process  entries  and  return  to  prior  menu 

STOP  -  ignore  entries  and  return  to  main  menu 

b.  To  leave  the  processor,  make  the  "STOP"  selection  on  the  current 
screen.  This  will  return  you  to  the  "MENU"  screen.  Make  the 
"STOP"  selection  again  to  terminate  the  session. 

c.  If  the  processor  aborts  and  a  system  register  dump  appears 
across  the  screen,  use  the  following  commands  to  restore  control 
to  the  keyboard. 

(1)  Enter  "CURSOR  TO  HOME". 

(2)  Enter  "UPPER  FUNCTION"  and  "ERASE  DIS"  together. 

(3)  Repeat  (1)  and  (2). 

(4)  Enter  an  SOE  symbol  followed  by  "@@END". 

(5)  Enter  an  SOE  symbol  followed  by  "@@X  TIO". 

d.  Refer  to  the  following  paragraphs  for  a  description  and 
illustration  of  each  screen. 


3.4.1.  Screen  01  -  MENU 


Description:  This  screen  presents  the  user  with  the  basic  screen 
groups  available. 

Utilization:  Select  screen  group  of  interest. 

Format:  See  Figure  II-3-2. 
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Figure  II-3-2.  Screen  01 
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3.4.2.  Screen  02  -  ORIENTATION  TO  MODEL 

5  Description:  This  screen  outlines  each  of  the  four  processors 

comprising  the  E-DATE  Model. 

Utilization:  Advance  through  orientation  using  "continue"  selection 
at  bottom  of  screen. 

ll  Format:  See  Figure  II-3-3. 
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3.4.3.  Screen  03  -  MODEL  DATA  PREPARATION 

Description:  This  screen  presents  the  user  with  the  three  data 
preparation  screen  groups  available. 

Utilization:  Select  screen  group  of  interest. 

Format:  See  Figure  II-3-4. 


I  1-3-10 


CAA-D-S5-7 


3.4.10.  Screen  10  -  MACOM  SELECTION 

Description:  This  screen  prompts  the  user  for  the  single  MACOM  to 
be  involved  in  the  red i stribution  of  equipment  assets  among  units.* 

Utilization:  Select  single  MACOM  of  interest. 

Format:  See  Figure  II-3-11. 


*The  E-OATE  Model  does  not  support  redistribution  of  data  associated 
with  "changed  units."  This  screen  is  provided  for  such  capability  if 
implemented  in  the  future. 
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3.4.9.  Screen  09  -  FISCAL  YEAR  SELECTION 

Description:  This  screen  prompts  the  user  for  the  single  fiscal 
year  involved  in  the  redistribution  of  equipment  among  units. 

Utilization:  Select  fiscal  year  of  interest.  Then  select  the 
(single)  data  set  desired. 

Format:  See  Figure  II-3-10. 
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3.4.8.  Screen  08  -  MACOM  SET  SELECTION 

Description:  This  screen  prompts  the  user  for  the  major  commands 
(MACOM)  to  be  included  in  the  rating  of  units  impacted  by  CTU 
changes. 

Utilization:  Select  MACOM  of  interest,  including  only  one  MACOM  or 
every  MACOM  ("All").  Note  that  the  choice  of  MACOM  implies  the  use 
of  "changed  units"  data  set  and  therefore  no  data  set  choice  is 
required. 

Format:  See  Figure  II-3-9. 
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3.4.7.  Screen  07  -  FISCAL  YEAR  RANGE  SELECTION 

Description:  This  screen  prompts  the  user  for  the  range  of  fiscal 
years  over  which  units  are  to  be  rated  and  the  data  set  involved. 

Utilization:  Select  "from"  and  "to"  fiscal  years  desired,  including 
the  choice  of  one  year,  by  indicating  the  same  year  for  "from"  and 
"to".  Then  select  the  (single)  data  set  desired. 

Format:  See  Figure  II-3-8. 
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3.4.6.  Screen  06  -  UNPROGRAMED  UNIT  BILLPAYERS 

Description:  This  screen  prompts  the  user  for  the  identification  of 
the  unprogramed  units  to  provide  the  equipment  assets  to  fill  the 
newly  created  units. 

Utilization:  Identify  the  criteria  for  selecting  the  billpayer 
units  from  which  assets  will  be  drawn  to  fill  the  newly  created 
units. 

TYP  -  The  type  of  identification  used  to  name  the  billpayer 
units,  namely,  "SRC",  "TOE",  or  "UIC".  Enter  an  "S",  "T",  or 
"U"  letter  for  selection  (see  bottom  of  screen). 

TYP  NOMEN  -  The  nomenclature  identifying  the  unit,  consistent 
with  the  above  "TYP"  selection,  namely,  a  9-character  code  for 
"SRC",  a  6-character  code  for  "TOE",  and  a  6-character  code  for 
"UIC". 

MACOM  -  The  major  command  from  which  the  billpayer  units  are  to 
be  selected. 

ALO  -  The  authorized  level  of  allowance  from  which  the  billpayer 
units  are  to  be  selected. 

8R  -  The  speciality  branch  from  which  the  billpayer  units  are  to 
be  selected. 

DAMPL  RANGE  -  The  priority  range  (DAMPL)  from  which  the 
billpayer  units  are  to  be  selected. 

Format:  See  Figure  II-3-7. 
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3.4.5.  Screen  05  -  UNPROGRAMED  UNIT  PARAMETERS 

Description:  This  screen  prompts  the  user  for  data  identifying  the 
unprogramed  units  to  be  introduced  into  the  force. 

Utilization:  Enter  identifying  values  as  follows: 

Proto  UIC  -  Each  UIC  to  be  used  for  equipment  requirements  for 
unprogramed  unit(s). 

QT  -  Number  of  units  to  be  created  from  Proto  UIC. 

CODE  -  Nomenclature  to  be  used  to  identify  each  created  unit 
(processing  will  add  a  2-digit  suffix  to  distinguish  among  units 
with  same  CODE  ) . 

EOATE  -  Effective  date  of  unit  entry  into  force  for  each  unit 
created  from  Proto  UIC. 

DAMPL  -  DAMPL  (priority)  to  be  assigned  to  newly  created  unit. 
Format:  See  Figure  II-3-6. 
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3.4.4.  Screen  04  -  DATA  SET  PARAMETERS 

Description:  This  screen  prompts  the  user  for  TAEDP 
cation  values  and  data  set  selection(s)  of  interest, 
nomenclature  to  be  associated  with  the  data  sets  in 
generation. 

Utilization:  Identify  data  sets  and  set  choices. 
Format:  See  Figure  II-3-5. 
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3.4.11.  Screen  11  -  POOL  SELECTION  CRITERIA 

Description:  This  screen  prompts  the  user  for  the  criteria  by 
which  units  will  be  selected  for  C-rating  uprate  and  downrate. 

A  separate  set  of  criteria  is  used  for  uprate  and  downrate. 

This  screen  is  used  in  conjunction  with  Screen  12  to  identify 
all  units  to  be  involved  in  the  redistribution.  This  screen 
focuses  on  identifying  units  by  their  characteristics,  while 
Screen  12  identifies  units  directly  by  their  UIC. 

Utilization:  Select  one  or  more  criteria  so  as  to  define  a 
pool.  At  least  one  criterion  must  be  selected  and  care  should 
be  exercised  as  additional  criteria  are  added  that  the  pool  does 
not  become  so  exclusive  that  few  or  no  members  are  admitted, 
since  each  member  must  meet  all  criteria  to  be  admitted  to  the 
pool.  The  following  parameters  are  used: 

POOL  C-RATING  -  The  C-rating  of  the  unit. 

MACOM  -  The  command  in  which  the  unit  exists. 

SRC  -  The  SRC  of  the  unit. 
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ALO  -  The  authorized  level  of  allowance  of  the  unit. 

BRANCH  -  Military  speciality  of  the  unit. 

DAMPL-LO  -  The  lowest  priority  unit  admitted. 

OAMPL-HI  -  The  highest  priority  unit  admitted. 

TGT  C-RATING  -  The  C-rating  value  which  all  members  of  the 
pool  must  achieve  (for  uprated  units)  and  below  which  down¬ 
rated  units  must  not  fall. 

Format:  See  Figure  II-3-12. 
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Figure  II-3-12.  Screen  11 


II-3-27 


i 


I  Jill  rfiiiifai 


CAA-0-85-7 


In 


3.4.12.  Screen  12  -  UNIT  TARGET  RATING  DESIGNATION 

Description:  This  screen  prompts  the  user  for  the  C-ratings  to  be 
associated  with  individual  units.  The  ratings  may  be  assigned  to 
either  uprate  or  downrate  the  unit  for  each  fiscal  year  in  the 
planning  cycle. 

Utilization:  Identify  each  unit  of  interest  by  its  UIC  and  enter  at 
least  one  C-rating  for  one  fiscal  year,  up  to  and  including  a 
C-rating  for  each  fiscal  year.  Note  that  this  assignment  of  a  unit 
C-rating  takes  precedence  over  the  pool  selection  criteria  (Screen 
11)  if  the  unit  also  happens  to  be  a  member  of  either  the  uprate  or 
downrate  pool . 

Format:  See  Figure  II-3-13. 
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Figure  II-3-13.  Screen  12 
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3.4.13.  Screen  13  -  MODEL  OPERATION 


Description;  This  screen  allows  the  user  to  select  the  processing 
to  be  carried  out  by  the  E-DATE  Model. 

Utilization;  Select  the  operation  of  interest  and  indicate  whether 
to  START  or  STOP  the  run. 


Format;  See  Figure  II-3-14. 
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Figure  II-3-14.  Screen  13 
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3.4.14.  Screen  14  -  STOP  RUN 

Description:  This  screen  advises  the  user  of  the  name  of  the  run 
the  user  has  requested  to  be  stopped. 

Utilization:  The  user  should  follow  the  instructions  indicated  on 
the  screen. 

Format:  See  Figure  II-3-15. 
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3.5.  Staff  Input 

Given  that  the  user  has  established  the  need  to  use  a  particular 
data  set  in  a  particular  mode  of  operation,  the  Request  Processor 
will  guide  the  user  through  the  input  and  run  execution  procedures 
as  described  previously  in  paragraph  3.4. 

3.6.  Output  Requirements 

The  Request  Processor  has  two  types  of  outputs,  both  of  which  are  in 
the  form  of  mass  storage  files.  Neither  of  the  file  types  directly 
involve  the  user.  In  fact,  any  user  involvement  with  these  files 
would  defeat  the  purpose  of  the  processor,  which  is  to  isolate  the 
user  from  the  mechanics  of  E-DATE  model  operation  at  the  system  level. 

3.7.  Utilization  of  System  Outputs 
Not  applicable. 

3.8.  Recovery  and  Error  Correction  Procedures 

3.3.1.  CPU  Failures 

In  the  event  of  an  overall  system  failure,  the  user  must  determine 
if  the  files  which  were  created  during  the  session  were  adversely 
affected  by  the  system  loss.  This  can  be  accomplished  by  reinvoking 
the  processor  and  calling  for  the  “edit"  option  offered  by  the  data 
preparation  screens.  This  will  display  the  file  contents  and  inspec¬ 
tion  will  reveal  if  any  faulty  data  are  present.  If  so,  corrected 
values  should  be  entered  and  the  screen  instructions  followed  to 
complete  the  re-input. 

3.3.2.  Request  Processor  Failure 

The  processor  provides  messages  on  the  progress  of  the  inputting 
process  at  the  bottom  of  each  screen.  If  any  messages  should  appear 
elsewhere  on  the  screen,  a  system  related  fault  has  occurred.  The 
user  should  try  to  terminate  the  session  with  one  or  more  "STOP" 
entries.  If  these  are  successful,  the  user  should  reinvoke  the 
processor  and  attempt  to  return  to  the  troublesome  screen  and 
reenter  the  selections,  paying  particular  attention  to  the  sequence 
of  operations  and  messages  generated  by  the  processor.  If  the 
system  fault  message  reappears,  the  program  maintenance  staff  should 
be  consulted  for  assistance. 
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SECTION  1.  GENERAL  DESCRIPTION 

1.1.  Purpose  of  the  Computer  Operation  Manual 

This  Computer  Operation  Manual  for  the  Request  Processor  supplements 
the  Computer  Operation  Manual  for  the  E-DATE  Model  (ref.  1.2a(3,']. 

It  presumes  reader  familiarity  with  the  E-DATE  Model  Computer  Opera¬ 
tion  Manual  and  is  to  provide  the  computer  operations  personnel  with 
an  operational  description  of  the  processor  and  its  associated 
environment.  The  focus  of  this  manual  has  been  directed  to  those 
aspects  of  the  processor  with  which  operations  personnel  will  be 
concerned  during  the  performance  of  their  duties.  In  addition,  it 
contains  all  the  executive  control  language  (ECL)  associated  with 
the  operation  of  the  processor. 

1 . .? .  Project  References 

a.  Effective  Date  (E-OATE)  Model  Documentation,  CAA-D-85-6,  US  Army 
Concepts  Analysis  Agency,  Bethesda,  MD,  May  1985. 

(1)  Volume  I  -  Functional  Description 

(2)  Volume  II  -  User's  Manual 

(3)  Volume  III  -  Computer  Operation  Manual 

(4)  Volume  IV  -  Program  Maintenance  Manual 

b.  Management  of  MTOE  Effective  Dates  Based  on  Equipment  Availa¬ 
bility  (MTO  Dates),  CAA-SR-83-3,  US  Army  Concepts  Analysis 
Agency,  Bethesda,  MD,  July  1983. 

c.  Effective  Date  (E-DATE)  Model  Enhancement,  CAA-SR-34-17 ,  US  Army 
Concepts  Analysis  Agency,  Bethesda.  MD,  July  1984. 

1.3.  Terms  and  Abbreviations 

See  Glossary. 
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SECTION  2.  SYSTEM  OVERVIEW 
2.1.  System  App1 ication 

The  Request  Processor  leads  the  user  through  the  steps  needed  to 
prepare  the  model  for  operation  and  allows  the  user  to  start  and 
stop  the  model,  all  with  only  a  minimal  familiarity  with  computer 
system  operating  procedures.  The  processor  presents  the  user  with  a 
series  of  choices  as  to  the  task  to  be  performed.  The  user 
indicates  the  task  of  interest,  and  the  processor  responds  with  a 
screen  soliciting  values  appropriate  to  the  task.  The  user  enters 
these  values,  and  the  processor  performs  basic  validity  checks.  If 
errors  are  encountered,  the  user  is  prompted  for  a  corrected  input. 
Otherwise,  the  processor  moves  on  to  solicit  another  task  until  all 
the  necessary  inputs  are  prepared  or  the  user  indicates  the  session 
is  to  be  terminated. 

System  Organization 

The  processor  program  generates  a  set  of  13  screens  (Figure 
III-2-1). 

a.  The  MENU  Screen  (#1)  is  the  master  directory  to  the  other 
screens.  It  allows  the  user  to  select  among  three  separate 
aspects  of  E-OATE  Model  operation,  namely: 

ORIENTATION  TO  MODEL 
MODEL  DATA  PREPARATION 
MODEL  OPERATION 

b.  The  ORIENTATION  TO  MODEL  Screen  (42)  provides  the  user  with  a 
multiple  page  summary  of  the  E-DATE  Model. 

c.  The  MODEL  DATA  PREPARATION  Screen  (#3)  acts  as  a  submenu  to 
allow  the  user  to  select  a  particular  data  preparation  sequence, 
namely: 

DATA  SET  IDENTIFICATION 
RATING  DATA  PARAMETERS 
REDISTRIBUTION  DATA  PARAMETERS 

d.  The  selection  of  the  Data  Set  Parameter  Sequence  causes  the 
following  screens  to  be  presented  in  turn: 

DATA  SET  IDENTIFICATION 
UNPROGRAMED  UNIT  PARAMETERS 
UNPROGRAMED  UNIT  BILLPAYERS 


The  DATA  SET  IDENTIFICATION  Screen  (<*4)  allows  the  user  to 
identify  the  data  sets  (units  and  associated  equipment)  to  be 
r'etrieved  from  the  TAEDP  data  tape. 
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e.  The  UNPROGRAMED  UNIT  PARAMETERS  Screen  (^5)  allows  the  user  to 
identify  the  paiameters  used  by  the  E-DATE  Model  to  create  new 
(unprogramed)  units. 

f.  The  UNPROGRAMED  UNIT  BILLPAYERS  SCREEN  (#6)  allows  the  user  to 
identify  the  units  from  which  equipment  may  be  transferred  to 
fill  the  newly  created  units. 

g.  The  selection  of  the  Rating  Data  Parameters  sequence  causes  the 
following  screens  to  be  presented  in  turn: 

FISCAL  YEA'i'  RANGE  SELECIION 
MACOM  SET  ^ELECTION 

The  FISCAL  YEAR  RANGE  SELECTION  Screen  iJ7)  allows  the  user  to 
select  the  particular  range  of  fiscal  years  of  interest  from  the 
seven  fiscal  years  present  in  the  TAEDP  data, 

h.  The  MACOM  SET  SEl.£CTION  Screen  (#3)  allows  the  user  to  select 
the  particular  major  commands  (MACOM)  of  interest  fi om  the  13 
MACOM  defined  in  the  TAEDP  data.  This  selection  of  MACOM  is 
(only)  used  in  conjunction  with  the  data  set  associated  with 
"changed  units." 

i.  The  selection  ot  the  Redistribution  Data  Parameters  sequerice 
causes  the  following  screens  to  be  presented  in  turn: 

SINGLE  FISCAL  YEAR  SELECTION 
SINGLE  MACOM  SELECTION 
POOL  SELECTION  CRITERIA 
UNIT  TARC-T  RATING 

The  SINGLE  FISl.-A.  YEAR  SELECTION  Screen  (^9)  allows  the  user  to 
select  the  particular  fiscal  year  to  be  involved  in  the 
equipment  redistribution  process. 

j.  The  SINGLE  MACOM  SELECTION  Screen  (^tlO)  allows  the  user  to 
select  an  individual  MACOM  to  be  involved  in  the  equipment 
redistribution  process.  This  selection  is  only  applicable  to 
the  data  set  associated  with  "changed  units"  and  is  provided  for 
use  in  the  future.  The  E-OATL  Model  does  not  presently  support 
redistribution  nt  equipment  among  "changed  units." 

s.  The  POOL  SELECTIifN  CRITERIA  Screen  (<tll)  allows  the  user  to 
select  the  parameters  which  control  the  units  selected  for 
uorate  to  a  hiqner  C-level  of  readiness  and  the  units  to  be 
selected  for  downrate  to  a  lower  C-level  of  readiness  (to 
nelease  assets  to  uprated  units). 
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3.2.  Prototype  Runstreams 

The  Request  Processor  constructs  runstreams  as  prescribed  by  the 
user  request.  The  runstreams  are  constructed  using  a  prototype  run- 
stream.  A  separate  prototype  runstream  is  provided  for  each 
processing  function  of  the  E-OATE  Model  and  includes  all  the  cases 
(e.g.,  fiscal  year  or  major  command)  possible  within  the  function. 
The  runstreams  are  stored  as  elements  in  the  Request  Processor  file 
and  at  execution  time  are  copied  into  temporary  files  for  access  by 
the  runstream  generation  code  within  the  Request  Processor.  These 
runstreams  are  divided  into  segments  using  a  dollar  sign  ($) 
delimiter  between  cases.  The  appropriate  segments  are  assembled  by 
the  processor  to  meet  the  specific  user  requirement  for  E-DATE  Model 
operation  and  loaded  into  a  constructed  runstream  file  (see 
para  3.3).  A  total  of  seven  prototype  runstreams  are  available,  as 
shown  in  Table  1 1 1-3-1. 
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Table  III-3-1.  Prototype  Runstreams 


Prototype  runstream 
(file,  element  name) 

Processing 

function 

RP1PRG00.DTAMLTP 

Generate  data  files  for 
converted  and/or  special 

activated  and/or 
units 

RP1PRG00.DTACHGP 

Generate  data  file  for  changed  (CTU)  units 

RP1PRG00.DTANONP 

Generate  data  files  for 

unprogramed  units 

RP1PRG00.RTGFYRP 

Generate  rating  of  units 

by  fiscal  year 

RP1PRG00.RTGCMDP 

Generate  rating  of  units 

by  command  (MACOM) 

RP1PRG00.DSTFYRP 

Distribute  assets  among 
fiscal  year 

units  for  a  particular 

RP1PRG00.DSTCMDP 

Distribute  assets  among 
command  (MACOM) 

units  for  a  particular 

The  individual  prototype  runstreams  are  shown  in  Figures  1 1 1-3-2 
through  III-3-8. 
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SECTION  3.  DESCRIPTION  OF  RUNS 

3.1.  Request  Processor  Runstream 

The  Request  Processor  is  invoked  with  a  command  (see  Part  II  -  User 
Manual,  paragraph  3.3)  which  calls  on  a  runstream  which  loads  the 
appropriate  files  and  machine  code  which  then  brings  up  the  first 
screen  of  the  processor.  The  runstream  which  performs  this 
operation  is  shown  in  Figure  III-3-1. 
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2.5.  Processing  Overview 

The  Request  Processor  is  a  special  utility  program  which  calls 
designed  computer-generated  full  screens.  These  screens  are 
designed  to  prompt  the  user  for  selected  groups  of  information, 
check  the  validity  of  the  entries,  and  then  pass  the  information  to 
a  file  for  subsequent  access  by  the  E-DATE  Model. 

2.6.  Security  and  Privacy 

2.6.1 .  Secur  i  t  y 

The  Request  Processor  code  is  UNCLASSIFIED.  The  files  generated  by 
the  processor  are  at  most  CONFIDENTIAL.  However,  these  files  are 
both  generated  and  employed  internal  to  the  computer  system  and  are 
totally  tr ansparent  to  the  user.  See  previous  para  2.4,  for  the 
identification  of  these  files. 

2.6.2.  Privacy 

Not  applicable. 
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2.4.  File  Inventory 
2.4.1.  Input  Files 


Table  III-2-1.  Request  Processor  Files  (Input) 


File 

Cl assif ication 

Content 

MTOE*RP1TYP01 

MTOE*RP1TYP02 

:4TOE*RP1TYP03 

UNCLASSIFIED 

UNCLASSIFIED 

UNCLASSIFIED 

Proto-runstream 

Proto-runstream 

Proto-runstream 

-  multiple  units 

-  changed  units 

-  unprogramed  units 

MTOE*RP1TYP04 

MTOE*RP1TYP05 

UNCLASSIFIED 

UNCLASSIFIED 

Proto-runstream 

Proto-runstream 

-  rating  by  FY 

-  rating  by  MACOM 

MTOE*RP1TYP06 

MTOE*RP1TYP07 

UNCLASSIFIED 

UNCLASSIFIED 

Proto-runstream 

Proto-runstream 

-  distribution  one  FY 

-  distribution  one  MACOM 

2.4.2.  Output  Files 


Table  III-2-2.  Request  Processor  Files  (Output) 


File 

Classification 

Content 

.■•1TOE*DTACTL01 

UNCLASSIFIED 

Data  set  selection 

MT0E*DTACTL22 

CONFIDENTIAL 

Prototype  Unit  selection 

MTOE*DTACTL03 

UNCLASSIFIED 

Billpayer  Unit  selection 

MTOE*DTACTL04 

CONFIDENTIAL 

Special  Unit  selection 

MTOE*RTGCTL01 

UNCLASSIFIED 

Rating  by  FY  selection 

MTOE*RTGCTL02 

UNCLASSIFIED 

Rating  by  MACOM  selection 

MTOE*OSTCTL01 

CONFIDENTIAL 

Distribution  by  one  FY 
selection 

MTi)E*:iSTCTL02 

UNCLASSIFIED 

Distribution  by  one  MACOM 
selection 

< 


I 


l.  The  UNIT  TARGET  RATING  Screen  (#12)  allows  the  user  to  select 
the  C-ratings  to  be  associated  with  particular  uprated  and  down¬ 
rated  units. 

m.  The  MODEL  OPERATION  Screen  (#13)  allows  the  user  to  "start"  or 
"stop"  the  E-OATE  Model  in  any  of  its  several  modes  of 
operation. 

n.  The  STOP  RUN  Screen  (#14)  is  automatically  generated  by  the 
processor  each  time  the  user  selects  the  "stop  run"  option  on 
Screen  #13.  It  displays  the  job  identification  of  the  run  to  be 
terminated.  It  also  displays  the  AUTOVON  number  of  the  LEA 
computer  operator  to  be  contacted  to  take  the  action  to 
terminate  the  run. 


Program  Inventory 

There  is  a  simple  program  associated  with  the  Request  Processor 
designated  MT0E*RP1PRG44. 
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3.3.  E-DATE  Model  Runstream 

The  E-DATE  Model  runstream  consists  of  the  ECL,  derived  from  the 
prototype  runstream,  associated  with  an  execution  of  one  or  two  of 
the  E-DATE  Model  processors  to  meet  a  particular  user  requirement 
for  E-DATE  Model  operation.  There  are  three  basic  types  of  E-DATE 
Model  operation  as  follows. 

3.3.1.  Data  Set  Generation 

The  E-DATE  Model  processes  data  from  the  TAEDP  into  separate  data 
set  files.  An  example  of  this  runstream  is  shown  in  Figure  III-3-9. 

3.3.2.  Unit  Equipment  Rating 

The  E-DATE  Model  processes  a  particular  data  set  file  and  computes 
the  rating  of  each  unit  present,  for  each  fiscal  year  present,  and 
processes  the  results  into  a  unit  equipment  rating  file.  An  example 
of  this  runstream  is  shown  in  Figure  III-3-10. 

3.3.3.  Unit  Equipment  Redistribution 

The  E-DATE  Model  processes  the  data  from  a  particular  unit  equipment 
rating  file  and  redistributes  the  equipment  assets  to  achieve  a 
prescribed  mix  of  unit  ratings  among  the  units  present  in  the  file. 
An  example  of  this  runstream  is  shown  in  Figure  III-3-11. 
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PART  IV  -  PROGRAM  MAINTENANCE  MANUAL 


SECTION  1.  GENERAL  DESCRIPTION 

1.1.  Purpose  of  Program  Maintenance  Manual 

This  Program  Maintenance  Manual  for  the  Request  Processor  supple¬ 
ments  the  Program  Maintenance  Manual  for  the  E-DATE  Model  (ref. 
1.2a(4).  It  presumes  reader  familiarity  with  the  E-DATE  Model 
Program  Maintenance  Manual  and  is  to  provide  the  maintenance 
programer  with  the  information  necessary  to  effectively  maintain  the 
processor. 

1.2.  Project  References 

a.  Effective  Date  (E-DATE)  Model  Documentation,  CAA-D-85-6,  US  Army 
Concepts  Analysis  Agency,  Bethesda,  MD,  May  1985. 

(1)  Volume  I  -  Functional  Description 

(2)  Volume  II  -  User's  Manual 

(3)  Volume  III  -  Computer  Operation  Manual 

(4)  Volume  IV  -  Program  Maintenance  Manual 

b.  Management  of  MTOE  Effective  Dates  Based  on  Equipment  Availa¬ 
bility  (MTO  Dates),  CAA-SR-83-3,  US  Army  Concepts  Analysis 
Agency,  Bethesda,  MD,  July  1983. 

c.  Effective  Date  (E-DATE)  Model  Enhancement,  CAA-SR-84-17,  US  Army 
Concepts  Analysis  Agency,  Bethesda,  MD,  July  1984. 


1.3. 


Terms  and  Abbreviations 
See  Glossary. 
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SECTION  2.  SYSTEM  APPLICATION 

2.1.  System  Description 

The  E-DATE  Model  can  be  used  by  the  logistics  staff  officer  to  assess 
unit  readiness  based  on  equipment  availability.  This  information 
enables  an  officer  to  make  a  judgment  as  to  whether  or  not  a  unit  is 
capable  of  fulfilling  its  mission. 

E-DATE  consists  of  three  processors: 

•  Tape  Processor  -  retrieves  data  from  TAEDP  for  selected  units 

•  File  Processor  -  extracts  data  for  the  selected  units  and 
reformats  the  data  for  the  Assessment  Processor 

t  Assessment  Processor  -  calculates  unit  readiness  using  the 
unit  rating  criteria  defined  by  AR  220-1 

These  processors  must  be  executed  in  the  sequence  given  above  with 
appropriate  data  sets  to  achieve  the  desired  readiness  calculations 
and  results.  A  fourth  processor,  the  Request  Processor,  provides 
the  logistics  staff  officer  a  means  to  run  the  first  three  processors 
individually  or  in  combination  with  each  other. 

The  Request  Processor  places  emphasis  on  building  data  files  necessary 
to  run  the  other  processors  rather  than  the  user  getting  involved  in 
the  technical  aspects  of  computer  operations,  although  a  minimal 
acquaintance  with  the  computer  system  and  model  operation  is  required. 

The  Request  Processor  provides  the  officer  with  a  series  of  screens 
to  build  data  files.  From  the  starting  (menu)  screen,  the  user  is 
prompted  for  inputs  which  lead  to  additional  screens  that  request 
additional  input  from  the  user.  The  Request  Processor  has  been 
designed  to  enable  the  logistics  staff  officer  to  generate  all  the 
data  files  necessary  to  execute  any  one  of  the  E-DATE  processors  in 
a  single  terminal  session  or  to  update  individual  screens  before 
running  a  processor.  Screen  input  is  checked  for  valid  entries. 

Error  messages  are  generated  for  invalid  entries,  and  the  user  is 
prompted  to  reenter  correct  values  for  invalid  entries. 

2.2.  Security  and  Privacy 
2.2.1  Security 

The  Request  Processor  is  UNCLASSIFIED.  The  files  generated  by  the 
processor  are  at  most  CONFIDENTIAL.  However,  these  files  are  both 
generated  and  employed  internal  to  the  computer  system  and  are  totally 
transparent  to  the  user.  See  Part  III  -  Computer  Operation  Manual, 
for  the  identification  of  these  files. 


IV-2-1 


CAA-D-85-7 
2.2.2.  Privacy 

Not  applicable. 

2.3.  General  Description 

The  Request  Processor  is  organized  around  three  types  of  screens: 

•  Model  Orientation 

•  Model  Data  Preparation 
t  Model  Operation 

Screens  are  generated  through  the  use  of  the  Sperry  UNI  VAC  Display 
Processing  System  (DPS).  DPS  enables  a  user  to  utilize  the  capabil¬ 
ities  of  a  terminal  without  having  knowledge  of  the  terminal's 
detailed  characteristics. 

The  present  version  of  DPS  creates  code  to  construct  a  screen  based 
on  the  COBOL  language.  This  code  is  incorporated  into  the  working- 
storage  section  of  a  COBOL  program.  Each  screen  has  its  own  COBOL 
program  that  validates  user  input  data  given  by  the  screen  and 
prompts  the  user  for  additional  entries,  if  appropriate. 

The  Request  Processor  has  1  main  program  and  12  subprograms.  Each 
of  these  programs  is  explained  more  fully  in  the  Program  Description, 
subsection  2.4.  An  initial  screen  (menu)  guides  the  user  to  one  of 
the  three  types  of  screens  given  above.  The  interrelationship  of 
all  the  screens  is  displayed  in  Figure  IV-2-1. 

The  functions  of  the  Model  Orientation  Screen  are  to: 

•  Provide  the  user  with  a  general  orientation  to  the  E-DATE 

Model . 

•  Define  the  use  of  the  end-of-screen  actions  available  to  the 
user--Continue,  Exit,  and  Stop. 

The  functions  of  the  Model  Data  Preparation  screens  are  to: 

•  Allow  the  user  to  create  new  data  files  for  the  execution  of 
the  E-DATE  processors  at  the  beginning  of  a  planning  cycle. 

•  Enable  the  user  to  update  data  files  within  a  planning  cycle 

by  adding  additional  data  items  to  a  particular  file  or  editing 
existing  data  items. 
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t  Give  the  user  a  choice  of  inputting  data  through  the  selection 
of  a  single  screen  or  a  series  of  screens  based  upon  one  of 
three  data  preparation  sequences.  The  three  sequences  as 
defined  by  Screen  #3  are  Data  Set  Parameters,  Rating  Data 
Parameters,  and  Redistribution  Data  Parameters. 

The  functions  of  the  Model  Operation  Screen  are  to: 

•  Permit  the  user  to  select  the  type  of  processing  desired. 

t  Schedule  the  processing  for  execution  through  the  selection  of 
the  Start  Run  option. 

•  Allow  the  user  to  terminate  processing  by  selecting  the  Stop 
Run  option. 

The  following  conventions  have  been  utilized  throughout  the  following 
pages  in  discussing  the  Request  Processor  programs. 

•  All  of  the  screens  displayed  in  Figure  IV. 2.1.  have  been  num¬ 
bered  for  ease  of  reference  from  1  to  14.  The  screen's  number 
appears  in  the  upper  left-hand  corner  of  the  process  boxes. 

The  name  in  each  process  box  refers  to  the  name  of  the  screen 
as  it  appears  on  the  DP  terminal. 

•  Bullets  (•)  and  indentations  are  utilized  in  the  "Processing" 
section  of  each  Program  Description  to  designate  programing 
levels.  Each  margin  (indentation)  with  a  bullet  starting  the 
line  will  represent  a  deeper  level  of  detail  in  the  code. 

f  The  definition  of  the  various  action  choices  available  to  the 
user  on  each  screen  will  be  explained  under  the  program 
description  for  that  screen. 

•  The  screen  number  for  each  program  in  the  program  description 
will  be  given  in  parentheses  following  the  name  of  the  pro¬ 
gram.  This  is  the  same  number  given  in  the  upper  left-hand 
corner  of  the  process  boxes  on  the  System  Flow  Diagram,  Figure 
IV-2-1. 
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Figure  IV-2-1.  System  Flow  Diagram 
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Program  Description  -  Request  Processor 


This  subsection  contains  a  description  of  all  the  program  units  for 
the  Request  Processor,  the  main  program,  and  the  12  associated  sub¬ 
programs.  A  complete  listing  of  all  the  program  units  is  given 
below. 


Paragraph  number 

2.4.1 

2.4.2 

2.4.3 

2.4.4 

2.4.5 

2.4.6 

2.4.7 

2.4.8 

2.4.9 

2.4.10 

2.4.11 

2.4.12 

2.4.13 


Program  unit 

SELCT-SCREEN 

EME-GUIDE 

EME-PREP 

DSET-ID 

DSET-NPUTS 

DSET-BPAYR 

RATE-ACTYR 

RATE-MACOM 

REDI-YR 

REDIS-MACOM 

REDI-POOL 

REDI-TARAT 

EME-EXECUTE 


Figure  IV. 2. 2.  provides  a  list  of  the  variables  contained  in  COBOL 
common  storage  and  the  linkage  section  cross-referenced  by  the  pro¬ 
grams  that  use  these  variables.  These  variables  control  the  flow  of 
screen  processing  within  the  Request  Processor  as  follows: 

•  MSTATUS:  It  is  given  a  value  of  "1"  or  "2"  within  the  EME-PREP 

program.  A  status  of  "I"  indicates  that  a  new  file  is  to  be 

created  from  data  entered  on  the  screen  referenced,  while  a 
status  of  "2"  refers  to  the  editing  of  a  file  previously  created 
from  the  same  screen. 

t  DP-CHOICE:  This  variable  is  set  in  EME-PREP  and  takes  on  a  value 
ranging  from  1  to  4.  The  first  three  values  present  the  user 
with  a  series  of  screens  within  the  areas  of  Data  Set  Parameters 
(screens  4-6),  Rating  Parameters  (screens  7-8),  and  Redistribution 
Parameters  (screens  9-12),  respectively.  A  value  of  4  indicates 
that  the  user  has  not  selected  a  series,  but  a  single  screen. 

•  E-FLAG:  It  is  set  to  an  initial  value  of  0  in  the  main  program 

SELCT-SCREEN.  The  value  is  set  to  1  if  the  user  selects  STOP  as 
his  action  choice  on  any  particular  screen.  This  choice  will 
take  the  user  back  to  the  starting  (menu)  screen,  and  no  data 
will  be  written  for  that  screen's  file. 
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Figure  IV-2-2.  Common  Slock  Cross  References 


WI 


I  J  J'  I  lllllllll.lj  .■lllll  11  II  I  IJ  III  I  I  IIHII.  Ill  Rill  I  III  HI  •  I  If  Pill  I  IVVf  Rf 


I 


CAA-D-85-7 


1 


I 


I 


I 

3 


► 


► 


I 


2.4.1.  Program  Unit— SELCT-SCREEN 

a.  Identification 

Request  Processor— SELCT -SCREEN ( 1 ) 

b.  Functions 


This  program  controls  the  running  of  the  Request  Processor.  It 
has  two  main  functions.  The  first  function  allows  the  user  to 
select  an  activity  organized  around  one  of  three  types  of  screens: 

•  Model  Orientation 

•  Model  Data  Preparation 

•  Model  Operation 

Secondly,  it  allows  the  individual  to  terminate  the  Request 
Processor. 

c.  Input 

User  input  data  from  Screen  #1. 

d.  Processing 


The  processing  for  SELCT-SCREEN  is  described  as  follows: 

•  User  selects  an  activity  that  allows  him  to  gain  access  to 
a  series  of  screens  in  one  of  the  above  stated  areas. 

f  User  then  selects  action  choice— continue  or  stop. 

t  The  screen  is  read  for  user  data. 

•  If  multiple  activities  selected  or  no  activity  selection 
made: 

•  Move  error  message  to  screen's  MSG  field. 

•  Mark  the  fields  on  the  screen  in  error  by  making  them 
blink. 

•  Resend  screen  to  user  for  data  reentry. 

•  If  no  action  choice  or  multiple  action  choice  made: 

•  Move  error  message  to  screen's  MSG  field. 
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•  Mark  the  fields  on  the  screen  in  error  by  making  them 
blink. 

•  Resend  screen  to  user  for  data  reentry. 

0  If  action  choice  is  "Continue"  call  next  screen: 

0  Call  EME-GUIDE  if  Model  Orientation  choice  made. 

0  Call  EME-PREP  if  Model  Data  Preparation  choice  made. 

0  Call  EME-EXECUTE  if  Model  Operation  choice  made. 

0  If  action  choice  is  "stop"  terminate  Request  Processor. 
Output 
None. 

Interfaces 


SELC7-SCREEN  is  the  main  program  that  controls  access  to  all 
other  screens.  It  is  not  called  by  any  other  program. 

Calls  to:  EME-GUIDE 

EME-PREP 
EME-EXECUTE 


Message  Texts 


0  Initial 
0  Error  1 
0  Error  2 
0  Error  3 
0  Error  4 


Select  Next  Action  Below 

No  Activity  Entry  Made  -  Select  One 

Multiple  Activity  Entries  Made  -  Select  Only  One 

Multiple  Action  Entries  Made  -  Select  One 

No  Action  Entry  Made  -  Select  One 


Action  Choice  Definitions 

0  Continue  -  Call  the  next  screen  as  determined  by  the  user's 
activity  choice. 


0  Stop  -  Terminate  the  Request  Process  in  a  normal  manner. 
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2.4.2.  Program  Unit— EME-GUIDE 

a.  Identification 

Request  Processor--EME-GUIDE(2) 

b.  Functions 

This  subprogram  reads  a  text  file  and  displays  the  text  on  the 
screen  for  the  orientation  of  the  user  to  the  Request  Processor. 
The  text  file  can  be  designed  to  discuss  any  aspect  of  the 
E-DATE  Model. 

c.  Input 
RPORENT. 

d.  Processing 

The  processing  for  EME-GUIDE  is  described  as  follows: 

•  Read  text  file. 

•  If  LNKT  is  less  than  17,  move  text  line  to  screen. 

•  When  LNKT  equals  16,  move  initial  message  to  MSG  field. 

•  Send  screen  of  text  to  user. 

•  Read  screen  for  user's  action  choice. 

•  If  no  action  choice  or  multiple  action  choice  made: 

9  Move  error  message  to  MSG  field. 

•  Mark  the  fields  on  the  screen  in  error  by  making  them 
blink. 

•  Resend  screen  to  user  for  data  reentry. 

•  If  action  choice  is  "continue": 

•  Send  a  new  screen  of  text  to  user  if  not  at  end  of  text 
file. 

•  Return  user  to  main  calling  program  if  at  end  of  text 
file. 

•  If  action  choice  is  "Exit,"  return  user  to  main  calling 
program. 
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e.  Output 


None. 

f.  Interfaces 


Called  by:  SELCT-SCREEN. 

g.  Message  Texts 

•  Initial:  Select  Next  Action  Below 

•  EOF:  End  of  E-DATE  Model  Guide 

•  Error  1:  Multiple  Action  Entries  Made  -  Select  One 

•  Error  2:  No  Action  Entry  Made  -  Select  One 

h.  Action  Choice  Definitions 


•  Continue  -  It  has  two  meanings  for  this  screen: 

•  The  choice  of  "Continue"  will  present  the  user  with 
additional  screens  of  text  orientation  to  the  User  Request 
Process  until  the  end  of  the  Text  File  is  reached. 

•  Once  the  last  screen  of  text  data  is  presented  to  the 
user,  this  choice  will  take  the  individual  back  to  the 
main  calling  program  SELCT-SCREEN. 

•  EXIT  -  "Exit"  is  used  to  return  to  the  main  calling  program 
without  completing  all  of  the  orientation  screens  to  the 
Request  Processor.  The  Text  File  is  closed  before  exiting 
this  subprogram. 
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Program  Unit — EME-PREP 

a.  Identification 

Request  Processor--EME-PREP(3) 

b.  Functions 

This  subprogram  allows  the  user  to  select  a  single  screen  or  a 
series  of  screens  to  input  data  necessary  for  the  execution  of 
the  E-DATE  Model  processors-  The  screens  are  numbered  from  4 
through  12  on  the  System  Flowchart,  Figure  IV-2-1.  The  user 
also  has  the  option  of  generating  a  new  data  file  from  the 
screen  data  or  editing  on  existing  file. 

c.  Input 

User  input  data  from  screen  #3. 

d.  Processing 

The  processing  for  EME-PREP  is  as  follows: 

•  User  selects  a  data  preparation  sequence  or  a  particular 
data  screen  to  input  data  for  E-DATE  Model  processors. 

•  User  selects  type  of  processing  desired  for  a  screen; 

•  If  MSTATUS  =  "1"  create  a  new  data  file. 

•  If  MSTATUS  =  "2"  edit  an  existing  data  file. 

0  User  selects  an  action  choice  -  Continue  or  Exit. 

0  Edit  checks  are  made  for  the  data  entered  on  the  screen  in 
the  above  areas. 

0  If  an  area  contains  no  choices  or  more  than  a  single 
choice: 

0  Move  appropriate  error  message  to  MSG  field. 

0  Mark  the  fields  on  the  screen  in  error  by  making  them 
blink. 

0  Resend  screen  to  user  for  data  reentry. 

0  If  action  choice  is  "continue”; 

0  Call  "DSET-ID"  when  DP-CHOICE  =  "1". 
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t  Error  8:  Multiple  Data  Set  Selection  Mode  -  Select  One 

•  Error  9:  Activated  Units  Not  Selected  On  Screen  #4 

•  Error  10:  Changed  Units  Not  Selected  On  Series  #4 

•  Error  11:  Unprogrammed  Units  Not  Selected  On  Screen  #4 
0  Error  12:  Converted  Units  Not  Selected  On  Screen  #4 

0  Error  13:  Special  Units  Not  Selected  On  Screen  #4 

0  Error  14:  No  Action  Entries  Made  -  Select  Only  One 

0  Error  15:  Multiple  Action  Entries  Made  -  Select  Only  One 

h .  Action  Choice  Definitions 

0  Continue  -  It  has  two  meanings  for  this  screen: 

0  The  next  screen  in  the  Rating  Data  Parameter  sequence  will 
be  called  if  DP-CHOICE  has  a  value  of  “I"  after  a  valid  FY 
range  has  been  input  by  the  user. 

0  Return  the  user  to  EME-PREP  (screen  #3)  if  the  value  of 
DP-CHOICE  =  "4".  This  value  indicates  that  an  individual 
screen  was  being  accessed  and  not  a  series  of  screens. 

0  Exit  -  ■’’his  action  takes  the  user  back  to  screen  #3  without 
checking  the  status  of  OP-CHOICE. 

0  Stop  -  The  user  is  returned  immediately  to  the  main  (menu) 
screen  without  writing  any  data  to  the  RP1CTL01  file.  The 
other  two  choices  will  always  allow  data  to  be  written  to  the 
data  file  before  terminating  the  screen. 


IV-2-25 


CAA-D-85-7 


0  Only  one  data  set  type  may  be  selected. 

0  If  input  fails  edit  checks: 

0  Move  appropriate  error  message  to  MSG  field. 

0  Mark  the  fields  in  error  on  the  screen  by  making  them 
blink. 

0  Resend  screen  to  user  for  data  reentry. 

0  If  action  choice  is  "Continue": 

0  Call  "RATE-MACOM"  if  DP-CHOICE  -  "1", 

0  Return  user  to  EME-PREP  (s^.-een  #3)  if  DP -CHOICE  =  "4". 

0  If  action  choice  is  "Exit"  return  user  to  EME-PREP 
irrespective  of  DP-CHOICE  value. 

e.  Output 
RP1CTL01  file. 

f .  Interfaces 

Called  by:  EME-PREP 
Calls  to:  RATE-MACOM 

g.  Message  Texts 

0  Initial  1:  Select  Next  Action  Below 

0  Initial  2:  File  Ready  For  Editinq  -  Reenter  Corrected  Values 
0  Error  1:  Error  In  Reading  Screen  ^4  File  For  Fiscal  Year 
0  Error  2:  No  From  FY  Made  -  Select  One 
0  Error  3:  Multiple  Selections  Made  -  Select  One 
0  Error  4:  No  To  FY  Selection  Made  -  Indicate  One 
0  Error  5:  Multiple  To  FY  Made  -  Select  One 
0  Error  6:  From  FY  Can't  Exceed  To  FY  -  Reenter  Choice 
0  Error  7:  No  Data  Set  Selected  -  Select  One 
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2.4.7.  Program  Unit— RATE -ACTYR 

a.  Identification 

Request  Processor  -  RATE-ACTYR(7) 

b.  Functions 

This  subprogram  allows  the  user  to  specify  a  range  of  fiscal 
years  and  type  of  units  to  be  used  by  the  File  Processor  for 
selecting  units  to  be  rated.  A  subset  of  the  fiscal  years  in 
the  TAEDP  file  may  be  selected  rather  than  using  all  seven 
fiscal  years.  If  the  user  specifies  an  FY  range  from  85  to  87, 
the  File  Processors  will  select  units  to  be  rated  for  each  of 
the  fiscal  years  within  the  FY  range  by  taking  units  from  the 
file  generated  by  the  Tape  Processor  according  to  the  selected 
data  set  type,  i.e.,  activated,  changed,  unprogramed,  converted, 
or  special  units.  The  data  set  type  selection  on  this  screen 
must  be  one  of  the  types  generated  from  TAEDP  on  Screen  #4.  A 
unit  may  appear  in  only  one  of  the  years  for  the  FY  range.  Each 
FY  will  cause  one  execution  of  the  assessment  processor  to  be 
run  for  rating  units  for  all  seven  years  of  the  planning  cycle. 

c .  Input 

User  input  data  from  screen  #7. 

Activation  year  range  from  RPlCTL01f ile. 

First  fiscal  year  of  the  TAEDP  data  file  from  DTACTL01. 

d.  Processing 

t  Obtain  first  fiscal  year  from  DTACTL01  to  set  up  the  FY 
range  on  screen  #7. 

0  Check  value  of  MSTATUS: 

0  If  MSTATUS  =  "1"  clear  screen  for  new  data  input. 

0  If  MSTATUS  =  "2"  read  data  file  and  present  old  data  to 
user  for  editing. 

0  If  action  choice  =  "Stop"  return  user  to  the  main  calling 
program  -  screen  #1. 

0  Edit  data  read  from  screen  for  "From  FY"  and  "To  FY"  years: 

0  A  fiscal  year  must  be  selected  for  each  column. 

0  The  "From  FY"  value  must  be  less  than  or  equal  to  the 
"To  FY"  value. 
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•  Exit  -  This  choice  takes  the  user  back  to  EME-PREP  without 
prompting  him  for  more  data  input  or  presenting  additional 
data  from  the  DTACTL03  file  for  editing. 

•  Stop  -  The  user  is  returned  immediately  to  the  main  (menu) 
screen  without  writing  any  data  from  the  screen  to  the  data 
file.  The  other  two  choices  will  always  allow  data  to  be 
written  to  the  output  file  before  terminating  the  screen. 
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•  Error  5:  Illegal  UIC  Type  -  Reenter  UIC 

•  Error  6:  Illegal  SRC  Type  -  Reenter  SRC 

•  Error  7:  Illegal  TOE  Entry  -  Reenter  TOE 

•  Error  8:  MACOM  Field  Blank  -  Reenter  WACOM  Code 

•  Error  9:  Invalid  MACOM  Code  -  Reenter  MACOM  Code 

t  Error  10;  ALO  Field  Blank  -  Enter  Valid  ALO  Code 

•  Error  11:  Invalid  ALO  Code  -  Reenter  Code 

•  Error  12:  Branch  Field  Blank  -  Enter  Valid  Code 

•  Error  13;  Invalid  BR  Code  -  Enter  Code 

•  Error  14:  DAMPL  Blank  -  Enter  Numeric  Value 

•  Error  15:  DAMPL  Values  Not  Numeric  -  Reenter  Value 

•  Error  16:  Low  DAMPL  Value  Out  Of  Range  -  Reenter  Value 

•  Error  17:  High  DAMPL  Value  Out  Of  Range  -  Reenter  Value 

•  Error  18:  Incorrect  DAMPL  Range  -  Reenter  Values 

•  Error  19:  No  Action  Entry  Made  -  Select  Only  One 

•  Error  20:  Multiple  Action  Entries  Made  -  Select  Only  One 

h.  Action  Choice  Definitions 

•  Continue  -  It  has  two  meanings  for  this  screen: 

•  Additional  blank  screens  are  sent  to  the  user  after  data 
on  the  screen  passes  all  edit  checks  and  is  stored  in 
array  BP-PARMS  during  file  creation.  Continue  will  keep 
the  user  within  screen  #6  for  data  input  up  to  99  entries. 
When  editing  an  existing  file,  this  action  choice  will 
cycle  the  user  through  several  screens  of  data  until  the 
end  of  file  is  reached. 

•  The  user  is  returned  to  EME-PREP  (screen  #3)  at  the  end  of 
data  input  or  file  editing  since  this  is  the  last  screen 
in  the  data  set  parameter  sequence. 


P 
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•  Check  DAMPL  values  (DAMPL  RANGE)  to  ensure  that  the 
entries  for  a  unit  go  from  a  lower  to  higher  value  or 
both  entries  have  the  same  value. 

•  If  user  input  fails  edit  checks: 

•  Move  appropriate  error  message  to  MSG  field. 

•  Mark  the  fields  on  the  screen  in  error  by  making  them 
blink. 

•  Resend  screen  to  user  for  data  reentry. 

•  If  action  choice  is  "Continue": 

•  Return  to  screen  #3  (EME-PREP)  if  at  the  end  of  new 
data  input  or  end  of  edit  file  after  writing  DTACTL03 
file. 

•  Save  screen's  data  and  clear  screen  for  additional  new 
data  input  or  present  additional  records  from  old  data 
file  for  editing. 

•  If  action  choice  is  "Exit"  write  DTACTL03  file  and 
return  to  screen  #3. 

e.  Output 
DTACTL03  file. 

f .  Interfaces 

Called  by:  EME-PREP 

OSET-NPUTS 

Calls  to:  None 

g.  Message  Texts 

•  Initial  1:  Select  Next  Action  Below 

•  Initial  2:  File  Ready  for  Editing  -  Reenter  Corrected  Values 

•  Error  1:  Number  Of  Entries  May  Not  Exceed  99 

•  Error  2:  Type  Not  Indicated  -  Select  S,  T,  or  U 

•  Error  3;  Illegal  Type  -  Select  S,  T,  or  U 

•  Error  4:  Nomenclature  Field  Blank  -  Enter  Nomenclature 
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iqram  Unit--DSET-BPAYR 
Identification 


Request  Processor  -  DSET-BPAYR{6) 
Functions 


This  subprogram  allows  the  user  to  generate  a  data  file  of 
Unprogramed  Unit  Billpayers  drawn  from  units  on  the  TAEDP  file. 
Units  are  classified  by  using  one  of  three  types  of 
designators--UIC,  TOE,  or  SRC.  Each  unit  is  further  defined  by 
specifying  its  WACOM,  ALO,  BR,  and  DAMPL  values.  These  units 
are  down-rated  from  their  level  of  readiness  by  having  items  of 
equipment  (LINs)  transferred  to  units  (Unprogramed  Units) 
selected  for  up-rating  in  subprogram  DSET-NPUTS. 

Input 

User  input  data  from  screen  #6. 

Data  from  DTACTL03  file. 

Processing 

t  Check  value  of  MSTATUS: 

•  If  MSTATUS  =  "1"  clear  screen  for  new  data  input. 

•  If  MSTATUS  =  "2"  read  data  file  and  present  old  data  to 
user  for  editing. 

•  If  action  choice  =  "Stop"  return  user  to  the  main  calling 
program  -  screen  #1. 

•  Edit  data  read  from  screen: 

•  Unit  type  (TYP)  must  be  "S",  "T",  or  "U". 

•  Nomenclature  (TYP  NOMEN)  must  be  an  SRC  for  type  "S",  a 
TOE  for  type  "T",  or  a  UIC  for  type  "U". 

•  Major  command  (WACOM)  entry  must  equal  one  of  the  13 
three-character  codes  stored  in  WS-MACOM-TABLE . 

•  Match  unit's  authorized  levels  of  organization  (ALO) 
entry  to  entries  in  WS-ALO-TABLE  for  valid  code. 

•  Compare  units  Branch  (BR)  against  Branches  stored  in 
WS-BRANCH-TABLE  for  valid  screen  entry. 
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•  Error  9:  Illegal  SRC  Type  -  Reenter  SRC 

t  Error  10;  Illegal  TOE  Entry  -  Reenter  TOE 

•  Error  11:  Code  Not  Indicated  -  Enter  Unique  4-Char  Set 

0  Error  12:  No  Action  Entry  Made  -  Select  Only  One 

0  Error  13;  Multiple  Action  Entries  Made  -  Select  Only  One 
h.  Action  Choice  Definitions 

0  Continue  -  It  has  three  uses  for  this  screen: 

0  Additional  blank  screens  are  sent  to  the  user  after  data 
on  the  screen  passes  all  edit  checks  and  is  stored  in 
NP-PARMS  during  file  creation.  Continue  will  keep  the 
user  within  screen  #5  for  data  input  up  to  99  entries. 

When  editing  an  existing  file,  this  action  choice  will 
cycle  the  user  through  several  screens  of  data  until  the 
end  of  file  is  reached. 

0  The  next  screen  in  the  data  set  parameters  sequence  will 
be  called  if  DP-CHOICE  has  a  value  of  ’’1"  at  the  end  of 

new  data  input  or  at  the  end  of  editing  data  from  an 

existing  file. 

0  Return  the  user  to  EME-PREP  (screen  #3)  after  completion 
of  data  input  or  editing  if  DP-CHOICE  =  "4".  This  value 
indicates  that  an  individual  screen  was  being  accessed  and 
not  a  series  of  screens. 

0  Exit  -  This  action  takes  the  user  back  to  screen  #3  without 
checking  the  status  of  DP-CHOICE. 

0  Stop  -  The  user  is  returned  immediately  to  the  main  (menu) 
screen  without  writing  any  data  from  the  screen  to  the 
OTACTL02  file.  The  other  two  choices  will  always  allow  data 
to  be  written  to  the  data  file  before  terminating  the  screen. 
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•  Mark  the  fields  on  the  screen  in  error  by  making  them 
blink. 

•  Resend  screen  to  user  for  data  reentry. 

•  Write  data  to  screen's  DTACTL02  file  at  the  end  of  new 
unit  input  or  end  of  edit  data  input. 

•  If  action  choice  is  "Continue": 

•  Call  "DSET-BPAYR"  if  DP-CHOICE  =  "1". 

•  Return  user  to  screen  #3  (EME-PREP)  if  DP-CHOICE  = 
"4". 

•  If  action  choice  is  "Exit"  return  user  to  screen  #3 
regardless  of  DP-CHOICE  value. 

Output 

DTACTL02  file. 


Interfaces 


Called  by:  EME-PREP 
OSET-IO 

Calls  to:  DSET-BPAYR 
Message  Texts 


Initial  1:  Select  Next  Action  Below 

Initial  2:  File  Ready  For  Editing  -  Reenter  Corrected  Values 


Error  1 
Error  2 
Error  3 
Error  4 
Error  5 
Error  6 
Error  7 
Error  8 


Number  of  Entries  May  Not  Exceed  99 
Quantity  Not  Indicated  -  Enter  Quantity 
Quantity  Not  Numeric  -  Reenter  Quantity 
Quantity  Must  Be  Greater  Than  Zero 
Type  Not  Indicated  -  Select  S,  T,  Or  U 
Illegal  Type  -  Select  S,  T,  Or  U 
Nomenclature  Field  Blank  -  Enter  Nomenclature 
Illegal  QIC  Type  -  Reenter  UIC 
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2. A. 5.  Program  Unit--DSET-NPUTS 

a.  Identification 

Request  Processor  -  0SET-NPUTS(5) 

b.  Functions 

This  subprogram  allows  the  user  to  generate  a  data  file  of 
unprogramed  units  based  upon  types  of  units  existing  in  the 
TAEDP  file.  The  user  does  this  by  inputting  screen  data 
specifying  the  type  and  quantity  of  unit  desired  up  to  a  maximum 
of  99  entries.  The  prototype  units  are  written  to  the  data  file 
for  later  use  by  the  other  E-DATE  Model  processors.  Unprogramed 
units  are  units  that  have  no  assets  but  receive  assets  from 
other  units  designated  as  unprogramed  billpayer  units. 

c.  Input 

User  input  data  from  screen  #5. 

Data  from  DTACTL02  file. 

d.  Processing 

•  Check  value  of  MSTATUS: 

•  If  MSTATUS  =  "1"  prepare  screen  for  new  data  input. 

•  If  MSTATUS  =  "2"  read  data  file  and  present  old  data  to 
user  for  editing. 

•  If  action  choice  =  "Stop"  return  user  to  the  main  calling 
program  -  screen  #1. 

•  Edit  data  read  from  screen: 

t  Proto  UIC  must  start  with  alphabetic  followed  by  five 
nonblank  fields. 

t  Quantity  (QY)  must  be  greater  than  0. 

•  Unit  code  field  (CODE)  must  be  nonbl ank--codes  to  be 
defined  by  user. 

•  E-DATE  must  be  numeric. 

•  DAMPL  must  be  numeric. 

•  If  user  input  fails  edit  checks: 

•  Move  appropriate  error  message  to  MSG  field. 
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Action  Choice  Definitions 

•  Continue  -  It  has  two  meanings  for  this  screen: 

•  Call  the  next  screen  in  the  Data  Set  Parameters 
sequence  if  DP-CHOICE  has  a  value  of  "1". 

•  Return  the  user  to  EME-PREP  (screen  #3)  if  DP-CHOICE 
equals  "4".  This  value  indicates  that  an  individual 
screen  was  being  accessed  and  not  a  series  of  screens. 

•  Exit  -  This  action  will  always  take  the  user  back  to 
screen  #3  without  checking  the  status  of  DP-CHOICE. 

•  Stop  -  Stop  returns  the  user  immediately  to  the  main 
(menu)  screen  without  writing  any  data  from  the  screen  to 
the  DTACTL01  file.  The  other  two  choices  will  always 
allow  data  to  be  written  to  the  data  file  before 
terminating  the  screen. 
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•  Call  "DSET-NPUTS"  if  DP-CHOICE  =  "1". 

•  Return  user  to  screen  #3  (EME-PREP)  if  DP-CHOICE  =  "4". 

•  If  action  choice  is  "Exit": 

•  Write  data  to  screen's  DTACTL01  file. 

•  Return  user  to  screen  #3  regardless  of  DP-CHOICE  value. 

e.  Output 
OTACTL01  file 

f .  Interfaces 

Called  by:  EME-PREP 
'-Calls  to:  DSET-NPUTS 

g.  Message  Texts 

•  Initial  1;  Select  Next  Action  Below 

•  Initial  2:  File  Ready  For  Editing  -  Reenter  Corrected  Values 

•  Error  1:  Inappropriate  Distribution  Month  -  Reenter  Month 

•  Error  2;  Inappropriate  Distribution  Day  -  Reenter  Day 

•  Error  3:  Inappropriate  Distribution  Year  -  Reenter  Year 

•  Error  4:  Inappropriate  Fiscal  Year  -  Reenter  Year 

•  Error  5:  No  Data  Set  Selection  Made  -  Enter  At  Least  One 

•  Error  6:  No  Identifier  Associated  With  Flashing  Data  Set  - 
Enter  Identifier 

•  Error  7:  No  Action  Entry  Made  -  Select  Only  One 

•  Error  8:  Identifier  Not  Valid  Without  Data  Set 

•  Error  9:  Multiple  Action  Entries  Made  -  Select  Only  One 
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2.4.4.  Program  Unit--DSET-ID 

a.  Identification 

t^equest  Processor--DSET-ID(4) 

b.  Functions 

This  subprogram  allows  the  user  to  select  the  first  fiscal  year 
within  the  TAEDP  file  for  which  data  will  be  used  from  the  TAEDP 
file.  The  user  then  indicates  the  type  of  unit  data  to  be  drawn 
from  TAEDP  for  use  by  one  of  the  other  E-DATE  Model 
processors— activated,  changed,  unprogramed  units,  converted 
units,  or  special  units. 

c.  Input 

User  input  data  from  screen  #4. 

Data  from  DTACTL01. 

d.  Processing 

•  If  MSTATUS  =  "1"  prepare  screen  for  new  data  input. 

•  If  MSTATUS  =  "2"  read  old  data  file  and  present  to  user  for 
editing. 

•  If  action  choice  =  "Stop"  return  user  to  the  main  calling 
program  -  screen  #1. 

t  Edit  data  read  from  screen: 

•  Distribution  month  (MM)  must  be  greater  than  00  and  less 
than  13. 

•  Distribution  day  (DD)  must  be  greater  than  00  and  cannot 
exceed  number  of  days  in  its  distribution  month. 

•  Distribution  year  (YY)  inust  equal  the  current  or  the 
previous  calendar  year. 

•  First  fiscal  year  (YY)  in  the  TAEDP  file  must  equal  the 
current  or  the  previous  calendar  year. 

•  One  or  more  Data  Sets  must  be  selected  along  with  the 
proper  identifier  being  supplied  by  the  user  where 
called  for. 

•  If  action  choice  is  "Continue": 

•  Write  data  to  screen's  DTACTL01  file. 
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•  Call  "RATE-ACTYR"  when  DP-CHOICE  =  "2". 


•  Call  "REDI-YR"  when  DP-CHOICE  =  "3". 

•  Call  one  of  the  screens  numbered  4  through  12  when 
DP-CHOICE  =  "4". 

•  If  action  choice  is  "Exit"  return  user  to  main  calling 
program. 

e.  Output 
None. 

f .  Interfaces 

Called  by:  SELCT-SCREEN. 


Calls  to:  DSET-ID 

DSET-NPUTS 

DSET-BPAYR 

RATE-ACTYR 

RATE-MACOM 

REDI-YR 

REDIS-MACOM 

REDI-POOL 

REDI-TARAT 


g.  Message  Texts 

•  Initial:  Select  Next  Action  Below 

•  Error  1:  Missing  Entry  In  Flashing  Sector  -  Enter  Selection 

•  Error  2:  Multiple  Entries  In  Flashing  Sector  -  Select  One 

•  Error  3:  Illegal  Screen  Number  -  Reenter  Number  Between  4-12 


h.  Action  Choice  Definitions 

•  Continue  -  This  choice  will  take  the  user  to  the  next  screen 
as  determined  by  a  choice  of  a  data  preparation  sequence  or 
selection  of  a  particular  screen  within  one  of  the  data 
preparation  sequences. 


•  Exit  -  "Exit"  will  take  the  user  back  to  the  main  (menu) 
screen. 
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2.4.8.  Program  Un1t--RATE-MAC0M 


a.  Identification 

Request  Processor  -  RATE-MAC0M(8) 

b.  Functions 

This  subprogram  allows  the  user  to  select  several  or  all  MACOMs 
presented  on  screen  #8.  The  File  Processor  will  gather  all 
units  for  each  MACOM  selected  and  pass  them  to  the  assessment 
processor  so  the  units  can  be  rated  one  MACOM  at  a  time. 

c.  Input 

User  input  data  from  screen  #8. 

MACOM  choices  from  RP1CTL02  file. 

d.  Processing 

t  Clear  screen  for  new  or  edit  data  input. 

•  Check  value  of  MSTATUS: 

•  If  MSTATUS  =  "1"  send  blank  screen  to  user. 

•  If  MSTATUS  =  "2"  present  user  with  prior  MACOM  choices 
from  RP1CTL02  file. 

•  If  action  choice  =  "Stop"  return  user  to  the  main  calling 
program  -  screen  #1. 

f  Edit  data  read  from  screen: 

fl  At  least  one  MACOM  must  be  selected. 

•  The  "All  MACOM"  choice  must  not  be  accompanied  by  other 
individual  MACOM  selections. 

•  If  input  fails  edit  checks: 

•  Move  appropriate  error  message  to  MSG  field. 

•  Mark  the  fields  in  error  on  the  screen  by  making  them 
blink. 

•  Resend  screen  to  user  for  data  reentry. 

•  Write  screen  choices  to  RP1CTL02  file. 

•  Return  user  to  EME-PREP  -  screen  #3. 
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RP1CTL02  file. 


Interfaces 

Called  by:  EME-PREP 

RATE-ACTYR 

Calls  to:  None 

Message  Texts 

•  Initial  1:  Select  Next  Action  Below 

•  Initial  2:  File  Ready  For  Editing  -  Reenter  Corrected  Value 

•  Error  1:  Invalid  MACOM  Entry  In  Data  File 

•  Error  2:  "ALL"  Selection  Precludes  Individual  Choice  - 
Reenter  Choices 

•  Error  3:  No  MACOM  Selected  -  Select  At  Least  One 

•  Error  4:  No  Action  Entries  Made  -  Select  Only  One 

•  Error  5:  Multiple  Action  Entries  Made  -  Select  Only  One 
Action  Choice  Definitions 


f  Continue  -  The  user  is  returned  to  EME-PREP  at  the  end  of 
data  input  or  file  editing  since  this  is  the  last  screen  in 
the  rating  data  parameter  sequence. 

•  Exit  -  This  choice  also  returns  the  user  to  EME-PREP  for  the 
same  reason  given  under  the  Continue  choice.  Both  choices 
allow  for  the  writing  of  screen  data  to  the  RP1CTL02  file 
before  closing  the  screen. 

•  Stop  -  The  user  is  returned  immediately  to  the  main  (menu) 
screen  without  writing  any  data  from  the  screen  to  the  data 
file. 
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dA.9.  Program  Uni t--REDI -YR 

a.  Identification 

Request  Processor  -  REDI-YR(9) 

b.  Functions 

This  subprogram  allows  the  user  to  select  a  single  fiscal  year 
within  the  TAEDP  seven  year  planning  cycle.  The  range  of  years 
is  based  upon  the  initial  fiscal  year  input  by  the  user  on 
screen  #4  and  written  to  the  DTACTL01  file.  Units  selected  for 
this  year  will  have  their  assets  (LINs)  redistributed.  Some 
units  will  be  donor  units  (Billpayers)  while  other  units  will 
acquire  the  equipment  released  by  the  donor  units.  The 
readiness  of  donor  units  may  or  may  not  decrease  as  a  result  of 
losing  equipment.  Units  receiving  the  donor  items  should  show 
an  increase  in  their  readiness. 

c.  Input 

User  input  data  from  screen  #9. 

Redistribution  fiscal  year  from  RP1CTL03  file. 

First  fiscal  year  of  the  TAEDP  data  file  from  DTACTL01  file. 

d.  Processing 

•  Obtain  first  fiscal  year  from  DTACTL01  file  to  set  up  the 
FY  range  on  screen  #9. 

•  Check  value  of  MSTATUS: 

•  If  MSTATUS  =  "1"  clear  screen  for  new  data  input. 

•  If  MSTATUS  =  "2"  read  data  file  and  present  old 
redistribution  FY  choice  to  user  for  editing. 

•  If  action  choice  =  "Stop"  return  user  to  the  main 
calling  program  -  screen  #1. 

•  Edit  FY  choice  from  screen  #9. 

•  User  must  choose  one  fiscal  year. 

•  Multiple  fi'.,cal  year  selections  are  not  allowed. 

•  If  input  fails  edit  criteria: 

•  Move  appropriate  error  message  to  MSG  field. 
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•  Mark  fields  in  error  on  the  screen  by  making  them 
blink. 

•  Resend  screen  to  user  for  data  reentry, 
t  If  action  choice  is  "Continue": 

•  Call  "REDIS-MACOM"  if  DP-CHOICE  =  "1". 

•  Return  user  to  EME-PREP  (screen  #3)  if  DP-CHOICE  = 
"4". 

•  If  action  choice  is  "Exit"  return  user  to  EME-PREP 
irrespective  of  DP-CHOICE  value. 

Output 

RP1CTL03  file. 

Interfaces 

Called  by:  EME-PREP 
Calls  to:  REDIS-MACOM 
Message  Texts 

•  Initial  1:  Select  Next  Action  Below 

•  Initial  2:  File  Ready  For  Editing  -  Reenter  Corrected  Value 

•  Error  1:  Error  In  Reading  File  On  Screen  #4  For  Fiscal  Year 

•  Error  2:  No  From  FY  Selection  Made  -  Select  Only  One 

•  Error  3:  Multiple  Selections  Made  -  Select  Only  One 

•  Error  4:  No  Action  Entries  Made  -  Select  Only  One 

•  Error  5:  Multiple  Action  Entries  Made  -  Select  Only  One 


•  Continue  -  It  has  two  meanings  for  screen 

•  The  next  screen  in  the  Redistribution  Data  Parameters 
sequence  will  be  called  if  DP-CHOICE  has  a  value  of  "I". 

•  Return  the  user  to  EME-PREP  (screen  #3)  if  the  value  of 
DP-CHOICE  =  "4".  This  value  indicates  that  an  individual 
screen  was  being  accessed  and  not  a  series  of  screens. 

•  Exit  -  This  action  returns  the  user  to  screen  #3  without 
checking  the  status  of  DP-CHOICE.  Both  "Continue"  and  "Exit 
allow  the  screen's  data  file  to  be  written  before  taking  the 
indicated  action. 

•  Stop  -  The  user  is  returned  immediately  to  the  main  (menu) 
screen  and  no  data  are  writ* ^n  to  the  output  file. 
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2.4.10.  Program  Unit— REDIS-MACOM 

a.  Identification 

Request  Processor  -  REDIS-MACOM(IO) 

b.  Functions 

This  subprogram  allows  the  user  to  select  a  single  MACOM  from 
among  those  presented  on  screen  #10.  The  units  within  this 
MACOM  will  be  candidates  for  upgrading  their  level  of  readiness 
or  having  their  level  of  readiness  downgraded.  Units  fall  into 
one  of  the  two  categories  depending  upon  user  criteria  specified 
on  screen  #11. 

c.  Input 

User  input  data  from  screen  #10. 

Data  from  RP1CTL04  file. 

d.  Processing 

•  Clear  the  screen  for  user  input  or  edit  file  data. 

•  Check  value  of  MSTATUS: 

•  If  MSTATUS  =  "1"  solicit  user  input. 

•  If  MSTATUS  =  "2"  read  data  file  and  present  previous 
MACOM  choice  to  user. 

•  If  action  choice  =  "Stop"  return  user  to  main  (menu) 
program  -  screen  #1. 

t  Edit  screen  to  ensure  that  individual  selected  only  a 
single  MACOM. 

0  If  no  MACOM  selected  or  multiple  selections  made: 

0  Move  appropriate  error  message  to  MSG  field. 

0  Mark  fields  in  error  by  making  them  blink  on  the  screen. 
0  Resend  screen  to  user  for  data  reentry. 

0  If  action  choice  is  "Continue": 

0  Write  data  to  RP1CTL04  file. 

0  C:ll  "REDI-POOL"  if  DP-CHOICE  =  "1". 
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•  Return  user  to  EME-PREP  (screen  #3)  if  DP-CHOICE  =  "4". 
•  If  action  choice  =  "Exit": 

•  Write  data  to  DSTCTL02  file. 

•  Return  to  EME-PREP. 

e.  Output 
RP1CTL04  file. 

f .  Interfaces 

Called  by:  REDI-YR 
EME-PREP 

Calls  to:  REDI-POOL 

g.  Message  Texts 

•  Initial  1:  Select  Next  Action  Below 

•  Initial  2:  File  Ready  For  Editing  -  Reenter  Corrected  Value 
f  Error  1:  MACOM  Entry  Not  A  Valid  Code 

•  Error  2:  Multiple  Selections  Made  -  Select  Only  One 

•  Error  3:  No  MACOM  Selected  -  Select  At  Least  One 

•  Error  4:  No  Action  Entries  Made  -  Select  Only  One 

•  Error  5:  Multiple  Action  Entries  Made  -  Select  Only  One 

h.  Action  Choice  Definitions 

•  Continue  -  It  has  two  meanings  for  this  screen: 

•  Call  "REDI-POOL"  if  DP-CHOICE  =  "1". 

•  Return  user  to  EME-PREP  (screen  #3)  if  DP-CHOICE  =  "4". 
This  value  indicates  that  REDIS-MACOM  was  called  directly 
by  EME-PREP. 

•  Exit  -  This  action  returns  the  user  to  EME-PREP  irrespective 
of  the  value  of  DP-CHOICE. 

•  Stop  -  The  user  is  returned  immediately  to  the  main  calling 
program  and  no  data  are  written  to  the  screen's  data  file. 
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2.4.11.  Program  Unit--REDI-P00L 
a.  Identification 


Request  Processor  -  REDI-P00L(11 ) 

b.  Functions 

This  subprogram  enables  the  user  to  specify  the  characteristics 
of  units  to  be  uprated  or  downrated.  The  criteria  are  applied 
to  units  in  an  uprate  and  a  downrate  pool.  For  both  pools  of 
units,  the  user  may  specify  any  or  all  of  the  following 
criteria:  Pool  C-Rating,  MACOM,  SRC,  ALO,  Branch,  DAMPL  range, 
and  a  TGT  C-Rating.  The  parameters  are  written  to  a  data  file 
and  saved  so  the  E-DATE  Model  can  use  them  in  rating  the 
readiness  of  individual  units. 

c.  Input 

User  input  data  from  screen  #11. 

Data  from  DSTCTL01  file. 

d.  Processing 

•  Check  value  of  MSTATUS: 

•  If  MSTATUS  =  "1"  clear  screen  for  new  data  input. 

•  If  MSTATUS  =  "2”  read  data  file  and  present  old  pool 
data  to  user  for  editing. 

0  If  action  choice  =  "Stop"  return  user  to  the  main 
calling  program  -  screen  #1. 

•  Edit  data  from  screen: 

•  If  TGT  C-Rating  for  one  pool  given,  TGT  C-Rating  for 
the  other  pool  need  not  be  present. 

•  If  both  TGT  C-Ratings  blank,  no  other  values  may  be 
specified  for  either  TGT  C-Ratings. 

•  If  TGT  C-Rating  is  given  for  either  the  Uprate  or 
Downrate  Pool  column: 

•  At  least  one  parameter  must  be  given  for  the 
Uprate  Pool  column  or  Downrate  Pool  column. 

•  The  only  exceptions  are  the  DAMPL  values  -  a  low 
and  a  high  value  must  be  given  to  form  the  DAMPL 
range. 


# 
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•  The  Uprate  Pool  C-Rating  must  be  greater  than  the 
Uprate  TGT  C-Rating. 

•  The  Downrate  Pool  C-Rating  must  be  less  than  the 
Downrate  Pool  TGT  C-Rating. 

•  For  individual  parameters,  the  following  criteria 

apply: 

•  The  values  for  the  Pool  and  TGT  C-Ratings  must  be 
greater  than  "0”  and  less  than  "5". 

•  The  MACOM  entry  must  match  one  of  14  entries  in 
WS-MACOM-TABLE. 

•  The  SRC  must  show  the  first  five  characters  as 
numeric,  the  sixth  character  as  alphabetic,  and  the 
last  three  as  numeric. 

•  The  ALO  entry  must  match  one  of  the  16  entries  in 
WS-ALO-TABLE. 

•  The  Branch  must  match  one  of  the  31  entries  in 
WS-BRANCH-TABLE. 

•  A  DAMPL  value  must  be  greater  than  "9999”  and  less 
than  "60000". 

•  The  low  DAMPL  value  must  be  less  than  or  equal  to 
the  high  DAMPL  value. 

f  If  input  fails  on  any  edit  criteria: 

•  Move  appropriate  error  message  to  MSG  field. 

•  Mar'  fields  in  error  on  screen  by  making  them  blink. 

•  Resend  screen  to  user  for  data  reentry. 

•  If  action  choice  is  "Continue": 

•  Ca.l  "REDI-TARAT"  if  DP-CHOICE  =  "1". 

0  Return  user  to  EME-PREP  (screen  #3)  if  DP-CHOICE  = 


0  If  action  choice  is  "Exit"  return  user  to  EME-PREP 
regardless  of  DP-CHOICE  value. 
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Output 


OSTCTL01  file. 
Interfaces 


Called  by;  REDIS-MACOM 
EME-PREP 

Calls  to:  REDI-TARAT 


Message  Texts 

•  Initial  1:  Select  Next  Action  Below 

•  Initial  2:  File  Ready  For  Editing  -  Reenter  Corrected  Value 

•  Error  1:  Error  In  Pool  File  Data  -  Check  File 

•  Error  2:  Entry  Not  Numeric  Or  Blank  -  Enter  Blinking 
Parameter 

•  Error  3:  TGT  C-Rating  (Uprate)  Requires  One  Uprate  Parameter 

•  Error  4:  TGT  C-Rating  (Downrate)  Requires  One  Downrate 
Parameter 


•  Error  5 

•  Error  6 

•  Error  7 
Adjust 


OAMPL-LO  (Uprate)  Greater  Than  DAMPL-HI  -  Adjust 
DAMPL-LO  (Downrate)  Greater  Than  DAMPL-HI  -  Adjust 
Pool  C-Rating  (Uprate)  Must  Be  Greater  Than  TGT  - 


•  Error  8:  Pool  C-Rating  (Downrate)  Must  Be  Less  Than  TGT  - 
Adjust 


•  Error  10 


•  Error  11 


•  Error  12 

•  Error  13 

•  Error  14 
Be  Valid 


Both  DAMPL  Values  Required  For  Valid  Entry 
A1 pha/Numer ic  Entry  Error  -  Please  Reenter  The  SRC 
Entry  Is  Not  Within  Acceptable  Range  -  Reenter 
Your  Entry  Is  Not  A  Valid  Code  -  Reenter  Please 
Both  TGT  C-Ratings  Required  For  Above  Entries  To 


•  Error  15;  No  Action  Entry  Made  -  Select  Only  One 


0  Error  16:  Multiple  Action  Entries  Made  -  Select  Only  One 
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h.  Action  Choice  Definitions 

•  Continue  -  It  has  two  meanings  for  this  screen: 

•  Call  REDI-TARAT  if  the  value  of  DP-CHOICE  =  "1". 

•  Return  user  to  EME-PREP  (screen  #3)  for  a  DP-CHOICE  value 
of  "4".  This  value  indicates  that  REDI-POOL  was  called 
directly  by  EME-PREP. 

•  Exit  -  This  action  returns  the  user  to  EME-PREP  without 
checking  the  value  of  DP-CHOICE. 

t  Stop  -  The  user  is  returned  immediately  to  the  main  calling 
program  without  writing  the  screen's  data  to  the  data  file. 
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2.4.12.  Program  Un1t--REDI-TARAT 

a.  Identification 


Request  Processor  -  REDI-TARAT(12) 

b.  Functions 


This  subprogram  allows  the  user  to  specify  individual  units  by 
UIC  that  will  be  rated  for  readiness.  The  desired  C-ratings  are 
given  for  each  unit  in  one  or  more  of  the  fiscal  years  within 
the  TAEDP  7-year  planning  cycle.  C-ratings  for  individual  units 
given  on  this  screen  will  take  precedent  over  the  Pool  C-rating 
(screen  #11)  if  a  unit  happens  to  be  included  within  a  pool. 

c .  Input 

User  input  data  from  screen  #12. 

Data  from  DSTCTL02  file. 

First  fiscal  year  of  the  TAEDP  data  file  from  DTACTL01  file. 

d.  Processing 

•  Obtain  fiscal  year  from  DTACTL01  file  to  establish  FY  range 
on  screen  #12. 

•  Check  value  of  MSTATUS: 

•  If  MSTATUS  =  "1"  clear  screen  for  new  data  input. 

•  If  MSTATUS  =  "2"  read  data  file  and  present  old  data  to 
user  for  editing. 

fl  If  action  choice  =  "Stop"  return  user  to  the  main  calling 
program  -  screen  #1. 

t  Edit  data  read  from  screen: 

•  Check  UIC  to  ensure  that: 

•  First  character  is  alphabetic. 

•  Characters  2  through  6  are  alphabetic  or  numeric. 

•  Check  C-Ratings  to  ensure  that: 

•  Each  UIC  entry  has  at  least  one  C-Rating. 

•  Values  for  C-Ratings  must  be  greater  than  "0"  and  less 
than  "5". 
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•  If  user  input  fails  edit  checks: 

•  Move  appropriate  error  message  to  MSG  field, 

•  Mark  fields  on  screen  in  error  by  making  them  blink. 

•  Resend  screen  to  user  for  data  reentry, 

•  If  action  choice  is  "Continue": 

•  Return  to  screen  (EME-PREP)  if  at  the  end  of  new  data 
input  or  end  of  edit  file  after  writing  DSTCTL0?  file. 

E 1  se 

•  Save  screen's  data  and  dear  screen  for  additional  new 
data  input  or  present  additional  records  from  old  data 
file  for  editing. 

0  If  action  choice  is  "Exit"  write  DSTCTL02  file  and  return 
to  screen  #3. 

e.  Output 

DSTCTL02  file. 

T „  Interfaces 

Called  by:  REDI-POOL 
EME-PREP 

Calls  to:  None 

q .  Message  Texts 

0  Initial  1;  Select  Next  Action  Below 

0  Initial  ?:  File  Ready  For  Editing  -  Reenter  Corrected  Values 
0  Error  1;  Number  of  Entries  May  Not  Exceed  99 

0  Error  ?;  Flashing  UlC  Invalid  -  Reenter 

0  Error  3:  No  Rating  For  Flashing  UIC  -  Enter  At  Feast  One 

0  Error  4:  Illegal  Value  For  Flashing  Entry  -  Reenter 

0  Error  B.  No  Entry  Action  Selected  -  Select  One 

0  Error  6:  Multiple  Action  Entries  Made  -  Select  Only  One 
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h.  Action  Choice  Definitions 

•  Continue  -  It  has  two  meanings  for  this  screen; 

•  Additional  blank  screens  are  sent  to  the  user  after  data 
on  the  screen  passes  all  edit  checks  and  is  stored  in 
array  REDISUNI-FORMAT  during  file  creation.  Continue  will 
keep  the  user  within  screen  #12  for  data  input  up  to  99 
entries.  When  editing  on  existing  file,  this  action 
choice  will  cycle  the  user  through  several  screens  of  data 
until  the  end  of  file  is  reached. 

•  The  user  is  returned  to  EME-PREP  (screen  #3)  at  the  end  of 
data  input  or  file  editing  since  this  is  the  last  screen 
in  the  Redistribution  Data  Parameters  sequence. 

•  Exit  -  This  choice  takes  the  user  back  to  EME-PREP  without 
prompting  him  for  more  data  input  or  presenting  additional 
data  items  from  DSTCTL0?  for  editing. 

•  Stop  -  The  user  is  returned  immediately  to  the  main  (menu) 
screen  without  writing  any  data  to  the  output  file.  The 
other  two  choices  will  always  allow  data  to  be  written  to  the 
output  file  before  terminating  the  screen. 
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2.4,13.  Program  Unit--EME-EXECUTE 
a.  Identification 


Request  Processor  -  EME-EXECUTE(13, 14) 
b.  Functions 


This  subprogram  has  two  basic  functions: 

•  To  set  up  runstreams  which  control  the  execution  of  the 
E-DATE  Model  processors. 

•  To  stop  the  execution  of  a  run. 

To  start  a  run,  the  user  selects  the  type  of  processing  desired. 
The  choices  include  Data  Set  Generation  Rating  Unit  Equipaient, 
or  Redistributing  Unit  Equipment.  Data  sets  can  be  generated 
for  converted  units,  unprogramed  units,  or  other  units  selected 
by  the  user.  Unit  equipment  can  be  rated  by  fiscal  year  or 
MACOM.  Unit  equipment  may  also  be  redistributed  by  fixed  year 
and  MACOM.  The  choice  "Start  Run"  will  then  start  the  execution 
of  the  appropriate  E-DATE  Model  processor. 

The  runstreams  for  the  execution  of  the  E-DATE  Model  processors 
are  built  from  prototype  runstreams.  These  prototypes  are 
divided  into  segments  using  a  two-character  delimiter.  The 
first  character  is  a  $  followed  by  an  alphabetic  or  numeric 
character.  Appropriate  segments  are  assembled  by  the  User 
Request  Processor  to  meet  user  requirements  for  E-DATE  Model 
applications.  These  are  a  total  of  7  prototype  runstreams. 

These  runstreams  are  shown  in  the  Computer  Operation  Manual, 
Figures  III"3"2  through  III-3-8  (ref.  1.2a(3)). 

A  run  that  has  already  been  started  may  be  halted  by  selecting 
the  appropriate  type  of  processing  and  selecting  the  operation 
"Stop  Run".  The  user  will  be  switched  to  screen  #14  that  will 
give  him  the  name  of  the  run  to  be  stopped.  He  then  calls  the 
computer  operator  requesting  that  the  run  be  terminated. 
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Input 

User  input  data  from  screen  #13 
DTACTL01. 

RP1CTL01. 

RP1CTL02. 

RP1CTL03. 

RP1CTL04. 

RP1TYP01. 

RP1TYP02. 

RP1TYP03. 

RP1TYP04. 

RP1TYP05. 

RP1TYP06, 

RP1TYP07. 

Processing 

t  Store  data  from  input  files  in  Working-Storage  data  tables. 

•  Prepare  screen  for  user  input. 

•  If  action  choice  =  "Stop"  return  user  to  the  main  calling 
program  -  screen  #1. 

•  Edit  data  read  from  screen: 

•  Only  one  type  of  processing  may  be  chosen  for 
execution--Data  Set  Generator,  Rating  Unit  Equipment,  or 
Redistributing  Unit  Equipment. 

•  Operation  selected  must  be  to  start  or  stop  execution  of 
a  run.  User  can  not  select  both  operations  at  the  same 
time. 

•  If  user  input  fails  edit  checks: 

•  Move  appropriate  error  message  to  MESSAGE  field. 

•  Move  spaces  to  fields  in  error. 

•  Resend  screen  to  user  for  data  reentry. 

•  If  Operation  =  "Start  Run": 


•  Build  a  runstream  for  the  type  of  processing  selected. 

FY  Range  and  single  fiscal  year  input  taken  from  screens 
#7  and  #9  are  used  to  select  data  by  fiscal  year  for  the 
type  of  processing  selected  by  the  user  on  screen  #13. 
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•  Start  the  run  b.y  generating  the  @START  of  the  runstream 
created.  This  is  done  by  issuing  an  Executive  Request 
through  a  call  to  "ERACSFS"  which  passes  the  ECL  @START 
statement  to  the  system  for  run  execution. 

•  Return  user  to  main  menu  -  screen  #1. 

•  If  Operation  =  "Stop": 

•  Close  screen  #13. 

•  Present  on  screen  #14  the  RUN  ID  based  on  data  input 
from  screen  #13  by  the  user.  The  user  can  then  call  the 
computer  operator  requesting  that  the  run  be  terminated. 

•  Return  user  to  the  main  menu  screen. 

e.  Output 

MT0E*MT0-LIB.RUN-EDATE 

f .  Interfaces 

Called  by:  SELCT-SCREEN 
Calls  to:  ERACSFS 

g.  Message  Texts 

•  Initial:  Select  Next  Action  Below 

•  Error  1:  Processing  Choice  Made  -  Select  One 

•  Error  2:  Multiple  Processing  Choices  -  Select  One 

•  Error  3:  No  Operation  Chosen  -  Select  One 

•  Error  4:  Multiple  Operations  Chosen  -  Select  One 

•  Error  5:  No  Action  Chosen  -  Select  One 

•  Error  6:  Multiple  Actions  Chosen  -  Select  One 

•  Error  7:  Starting  FY  Not  In  MTOE*RP1RTG01 . 

•  Error  8:  Starting  MACOM  Not  In  MTOE*RP1RTG02 . 

•  Error  9:  Requested  FY  Not  In  MTOE*RP1DST01 . 

•  Error  10:  Requested  MACOM  Not  In  MTOE*RP1DST02. 
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h.  Action  Choice  Definitions 

•  Continue  -  It  has  two  meanings  within  EME-EXECUTE  depending 
on  whether  or  not  the  choice  is  made  on  screen  #13  or  #14: 

•  If  the  user  starts  a  run  (screen  #13)  this  action  choice 
returns  the  user  to  the  main  (menu)  program. 

•  If  the  user  is  terminating  a  run  this  choice  will  take  the 
user  to  screen  #14.  The  user  is  returned  to  the  main 
(menu)  program  from  screen  #14. 

•  Stop  -  This  action  choice  will  take  the  user  back  to  the  main 
(menu)  calling  program  from  either  screen  #13  or  screen  #14 
without  taking  the  indicated  action  dictated  by  other  choices 
made  on  the  screens. 
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SECTION  3.  ENVIRONMENT 


3.1.  Equipment  Environment 

The  Request  Processor  is  resident  on  the  Sperry  1100/62  Timesharing 
Multiprocessing  System  at  the  Logistics  Evaluation  Agency  (LEA). 
Off-site  access  to  the  LEA  system  is  provided  through  terminal 
devices  including  the  UTS  20  and  associated  controllers  located  in 
the  ODCSLOG  work  area. 

3.2.  Support  Software 

The  Request  Processor  requires  the  availability  of  the  Sperry 
Display  Processing  System  to  enable  generation  of  the  full  screen 
displays.  In  addition,  the  processor  would  require  the  availability 
of  the  Sperry  COBOL  compiler,  associated  libraries,  and  the  system 
collector  in  the  event  that  any  changes  to  the  processor  code  are  to 
be  made. 

3.3.  Data  Base 


A  data  base  as  such  is  not  involved.  The  processor,  however,  does 
access  prototype  runstreams.  These  runstreams  have  been  specially 
edited  with  symbols  which  mark  off  the  runstream  into  segments. 

These  segments  are  used  by  the  processor  and  assembled  into  the 
appropriate  order  to  generate  the  required  sequence  of  executions  of 
the  E-OATE  Model. 


SECTION  4.  PROGRAM  MAINTENANCE  PROCEDURES 


4.1.  Conventions 

Certain  conventions  were  followed  in  naming  programs  and  files  for 
the  Request  Processor.  All  the  programs  were  named  for  the  screens 
they  control  and  can  be  grouped  into  three  broad  categories: 

•  Category  1  (Model  Orientation):  EME-GUIDE 

•  Category  2  (Model  Data  Preparation):  EME-PREP 

•  Data  Set  Parameters  DSET-ID 

DSET-NPUTS 

DSET-BPAYR 

•  Rating  Data  Parameters  RATE-ACTYR 

RATE-MACOM 

•  Redistribution  Data  Parameters  REDI-YR 

REDIS-MACOM 

REDI-POOL 

REDI-TARAT 

•  Category  3  (Model  Operation):  EME-EXECUTE 

The  main  program  (SELCT-SCREEN)  allows  the  user  to  select  one  of  the 
three  categories  of  screens. 

Data  File  names  are  eight  characters  in  length  and  subdivided  as 
Follows: 

1-3  Type  of  Category  2  parameter  -  DTA  (Data  Set),  RTG  (Rating 
Data),  and  DST  (Redistribution  Data) 

4-6  Type  of  file  (CTL  -  Control  File) 

7  Classification  (0  -  unclassified,  2  -  confidential,  4  - 
secret ) 

8  File  number  within  one  of  the  areas  for  a  Category  2  file 
Data  written  to  these  files  control  the  running  of  the  E-DATE  Model. 

4.2.  Verification  Procedures 

The  only  verification  procedures  followed  are  the  edit  checks  that 
screen  data  are  subject  to  before  being  written  to  screen  data 
files.  These  edit  checks  are  discussed  under  individual  programs  in 
Section  2,  Program  Description. 
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4.3.  Error  Conditions 


•  The  errors  chat  can  occur  while  running  the  Request  Processor 
are  listed  under  individual  program  descriptions  in  Section  2. 

A  list  of  all  the  user  errors  that  can  occur  while  editing  or 
inputting  data  into  screen  files  is  given. 

t  Several  screens  will  return  an  error  message  if  an  error  is 
encountered  in  reading  file  DTACTL01  for  the  first  fiscal  year 
of  the  TAEDP  file.  DTACTL01  is  the  file  for  screen  #4.  This 
fiscal  year  is  used  as  the  starting  year  to  set  up  the  fiscal 
year  range  for  screens  7,  9,  and  12.  The  user  must  indicate 
the  TAEDP  fiscal  year  on  screen  #4  before  attempting  to  input 
or  edit  on  the  other  screens. 

•  The  programs  for  screens  5,  6,  and  12  will  accept  up  to  99  lines 
of  data.  If  the  user  attempts  to  input  more  than  99  entries,  a 
message  is  flashed  on  the  screen  that  the  number  of  entries  may 
not  exceed  99.  The  first  99  entries  are  written  to  the  screen's 
data  file  and  the  user  is  returned  to  the  calling  program  EME- 
PREP  (screen  #3).  On  a  read  of  the  data  files  for  the  screens 
in  the  edit  mode,  more  that  99  entries  will  also  cause  an  error 
message  to  be  generated  and  an  exit  from  the  screen  to  be  made, 

•  Screen  #13  (EME-EXECUTE)  uses  data  input  by  the  user  into  files 
RTGCTL01  (screen  #7),  RTGCTL02  (screen  #8),  DSTCTLOl  (screen 
#9),  and  0STCTL02  (screen  #10).  The  data  is  edited  and  validated 
as  being  correct  before  written  to  these  files.  For  example, 
screen  #10  asks  the  user  to  select  one  WACOM  of  interest  from 
those  presented  on  the  screen.  These  are  the  only  valid  MACOMs. 
The  WACOM  read  from  DSTCTL02  is  revalidated  on  input  to  screen 
#13.  An  invalid  WACOM  will  result  in  an  error  message  notifying 
the  user  that  an  error  has  occurred  in  the  data  file.  The 
execution  of  the  appropriate  E-DATE  Model  processor  will  not  be 
started  from  screen  #13.  Normally,  this  situation  will  only 
occur  if  someone  inserts  an  invalid  data  item  into  one  of  the 
screen  files  outside  of  normal  use  of  the  Request  Processor  and 
need  not  concern  the  user. 

•  All  other  error  messages  should  originate  from  the  Sperry 
Operating  System  (EXEC)  and  should  be  referred  to  the  resident 
Sperry  system  personnel. 

4.4.  Special  Maintenance  Procedures 


•  Executive  Control  Language  (ECL).  The  ECL  to  run  the  User 
Request  Processor  is  shown  in  the  Computer  Operation  Manual, 
Figure  III-3-1  (ref.  1.2a(3)).  To  start  the  Processor  refer  to 
the  @ADD  command  shown  in  the  User's  Manual,  paragraph  3-3 
(ref.  1.2a(2)) 


# 
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0  Compile  and  Mapping  Procedures.  All  the  programs  for  the 
Request  Processor  are  written  in  Sperry  ASCII  COBOL.  Figure 
IV-4-1  shows  the  compile  statement  for  the  programs.  The 
operations  are  as  defined  in  the  Sperry  COBOL  manual.  Every 
program,  except  SELCT-SCREEN,  is  compiled  using  the  V-option. 
This  option  indicates  that  the  program  being  compiled  is  a 
subprogram  being  called  by  the  main  program  or  another  sub¬ 
program.  The  ECL  statements  to  the  Request  Processor  are 
given  in  Figure  IV-4-2.  The  name  of  the  file  is 
MT0E*RP1PRG00.MAP-RP1. 

Special  Maintenance  Programs 

The  Request  Processor  consists  solely  of  the  13  programs  that  manip¬ 
ulate  the  input  by  the  user  on  the  various  screens  of  the  processor. 

No  maintenance  programs  are  involved. 

Listings 

The  program  listings  for  the  Request  Processor  may  be  generated  from 
the  LEA  production  library.  This  library  contains  all  the  symbolic, 
relocatable,  and  absolute  elements  as  well  as  the  runstreams  necessary 
to  execute  the  Request  Processor. 
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9AC0B,  options  FILE  .  ELEMENT 

:3(T0  PROMPT  COMPILER) 

Figure  IV-4-1.  Compiler  Call  Statement 

3  MAP,E,  MT0E*MT0-LIB.MAP-RP1 

IN 

MTOE*MTO-LIB.SELCT-SCREEN 

IN 

MTOEWO-LIB.EME-PREP 

IN 

MTOE*MTO-LI8.EME-PRSYSDTA 

IN 

MTOEWO-LIB.DSET-ID 

IN 

MTOE*MTO-LIB.DSET-ISYSDTA 

IN 

MTOE*MTO-L I B . DSET-NPUTS 

IN 

MTOE*MTO-L I B , DSET-NSYSDA 

IN 

MTOE*MTO-LIB,DSET-BPAYR 

IN 

MT0E*MT0-LIB.DSET-8SYSDTA 

IN 

MTOE*MTO-LlB.EME-GUIDE 

IN 

MTOE*MTO-L 1 8 . EME -6US YSDTA 

IN 

MTOEWO-LIB.RATE-ACTYR 

IN 

MTOE*MTO-LIB.RATE-ASYSDTA 

IN 

MTOEWO-L I B .  RATE  -MACOM 

IN 

MTOE*MTO-L I B . RATE -MS YSDTA 

IN 

MTOE*MTO-LIB.REDI-YR 

IN 

MTOE*MTO-LIB.REDI-YSYSDTA 

IN 

MTOEWO-LIB.REDI-POOL 

IN 

MTOE*MTO-LIB.REDI-PSYSDTA 

IN 

MTOE*MTO-LIB.REDI-TARAT 

IN 

MTOE*MTO-L I B .REDI -TSYSDTA 

IN 

MTOEWO-L  I  B.REDIS-MACOM 

IN 

MTOEWO-L  IB.  REDI  S-SYSDTA 

IN 

MTOEWO-L  I B .  EME  -EXECUTE 

IN 

MTOEWO-LIB.EME-EXSYSDTA 

LIB 

LIB$*0PS-1R3. 

END 

Figure  IV-4-2.  Mapping  Procedure 
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ALO 

AR 

BR 

CAA 

C-rati ng 
C-1 evel 
CSR 
CTU 
DA 

DAMPL 

DESCOM 

DPS 

ECL 

E-DATE 

ID 

ILD 

LEA 

MACOM 

MTOE*MTO-LIB 

ODCSLOG 

ODCSOPS 

POOL 


GLOSSARY 

authorized  level  of  organization 

Army  regulation 

branch  of  service 

US  Army  Concepts  Analysis  Agency 

readiness  measure  (AR  220-1) 

interchangeable  with  C-rating 

Chief  of  Staff  Regulation 

Consolidated  Table  of  Organization  Update 

Department  of  the  Army 

Department  of  Army  Master  Priority  List 

US  Army  Depot  System  Command 

Display  Processing  System  (on  Sperry  computer) 

Executive  Control  Language  (on  Sperry  computer) 

Effective  Date  (mode!) 

identification 

Integtral  Load  Device  (on  Sperry  computer) 

US  Army  Logistics  Evaluation  Agency 
major  Army  command 
library  file  at  LEA 

Office  of  the  Deputy  Chief  of  Staff  for  Logistics 

Office  of  the  Deputy  Chief  of  Staff  for  Operations  and 
P 1  ans 

particular  group  of  units 
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SRC 

SS5 

"AEDR 

JIC 

JPU 


standard  requirements  code 

Symbolic  Stream  Generator  (on  Sperry  computer) 
Total  Army  Equipment  Distribution  Program 
unit  identification  code 
unprogramed  units 
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